@dangao/bun-server 1.5.0 → 1.6.0

package/dist/core/server.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../src/core/server.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,KAAK,CAAC;AAClC,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,uBAAuB,CAAC;AACtE,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,uBAAuB,CAAC;AAErE;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B;;OAEG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd;;OAEG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB;;OAEG;IACH,KAAK,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC;IAE1D;;OAEG;IACH,iBAAiB,CAAC,EAAE,wBAAwB,CAAC;IAE7C;;;OAGG;IACH,uBAAuB,CAAC,EAAE,MAAM,CAAC;CAClC;AAED;;;GAGG;AACH,qBAAa,SAAS;IACpB,OAAO,CAAC,MAAM,CAAC,CAAkC;IACjD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAgB;IACxC,OAAO,CAAC,cAAc,CAAa;IACnC,OAAO,CAAC,cAAc,CAAkB;IACxC,OAAO,CAAC,eAAe,CAAC,CAAgB;IACxC,OAAO,CAAC,eAAe,CAAC,CAAa;gBAElB,OAAO,EAAE,aAAa;IAIzC;;OAEG;IACI,KAAK,IAAI,IAAI;IA2FpB;;OAEG;IACI,IAAI,IAAI,IAAI;IAWnB;;;;;OAKG;IACU,gBAAgB,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IA2C9D;;OAEG;IACI,iBAAiB,IAAI,MAAM;IAIlC;;OAEG;IACI,mBAAmB,IAAI,OAAO;IAIrC;;;OAGG;IACI,SAAS,IAAI,MAAM,CAAC,uBAAuB,CAAC,GAAG,SAAS;IAI/D;;;OAGG;IACI,SAAS,IAAI,OAAO;IAI3B;;OAEG;IACI,OAAO,IAAI,MAAM;IAIxB;;OAEG;IACI,WAAW,IAAI,MAAM,GAAG,SAAS;CAGzC"}
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../src/core/server.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,KAAK,CAAC;AAClC,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,uBAAuB,CAAC;AACtE,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,uBAAuB,CAAC;AAErE;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B;;OAEG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd;;OAEG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB;;OAEG;IACH,KAAK,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC;IAE1D;;OAEG;IACH,iBAAiB,CAAC,EAAE,wBAAwB,CAAC;IAE7C;;;OAGG;IACH,uBAAuB,CAAC,EAAE,MAAM,CAAC;CAClC;AAED;;;GAGG;AACH,qBAAa,SAAS;IACpB,OAAO,CAAC,MAAM,CAAC,CAAkC;IACjD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAgB;IACxC,OAAO,CAAC,cAAc,CAAa;IACnC,OAAO,CAAC,cAAc,CAAkB;IACxC,OAAO,CAAC,eAAe,CAAC,CAAgB;IACxC,OAAO,CAAC,eAAe,CAAC,CAAa;gBAElB,OAAO,EAAE,aAAa;IAIzC;;OAEG;IACI,KAAK,IAAI,IAAI;IAmGpB;;OAEG;IACI,IAAI,IAAI,IAAI;IAWnB;;;;;OAKG;IACU,gBAAgB,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IA2C9D;;OAEG;IACI,iBAAiB,IAAI,MAAM;IAIlC;;OAEG;IACI,mBAAmB,IAAI,OAAO;IAIrC;;;OAGG;IACI,SAAS,IAAI,MAAM,CAAC,uBAAuB,CAAC,GAAG,SAAS;IAI/D;;;OAGG;IACI,SAAS,IAAI,OAAO;IAI3B;;OAEG;IACI,OAAO,IAAI,MAAM;IAIxB;;OAEG;IACI,WAAW,IAAI,MAAM,GAAG,SAAS;CAGzC"}

package/dist/index.js

@@ -3264,8 +3264,14 @@ class BunServer {
           if (!this.options.websocketRegistry.hasGateway(url.pathname)) {
             return new Response("WebSocket gateway not found", { status: 404 });
           }
+          const context2 = new Context(request);
+          const queryParams = new URLSearchParams(url.searchParams);
           const upgraded = server.upgrade(request, {
-            data: { path: url.pathname }
+            data: {
+              path: url.pathname,
+              query: queryParams,
+              context: context2
+            }
           });
           if (upgraded) {
             return;
@@ -3291,14 +3297,14 @@ class BunServer {
         return responsePromise;
       },
       websocket: {
-        open: (ws) => {
-          this.options.websocketRegistry?.handleOpen(ws);
+        open: async (ws) => {
+          await this.options.websocketRegistry?.handleOpen(ws);
         },
-        message: (ws, message) => {
-          this.options.websocketRegistry?.handleMessage(ws, message);
+        message: async (ws, message) => {
+          await this.options.websocketRegistry?.handleMessage(ws, message);
         },
-        close: (ws, code, reason) => {
-          this.options.websocketRegistry?.handleClose(ws, code, reason);
+        close: async (ws, code, reason) => {
+          await this.options.websocketRegistry?.handleClose(ws, code, reason);
         }
       }
     });
@@ -3403,6 +3409,8 @@ function getHandlerMetadata(target) {
 }
 
 // src/websocket/registry.ts
+init_param_binder();
+init_decorators2();
 class WebSocketGatewayRegistry {
   static instance;
   container;
@@ -3443,47 +3451,90 @@ class WebSocketGatewayRegistry {
   getGateway(path) {
     return this.gateways.get(path);
   }
-  getGatewayInstance(definition) {
-    if (!definition.instance) {
-      definition.instance = this.container.resolve(definition.gatewayClass);
-    }
-    return definition.instance;
+  createGatewayInstance(definition) {
+    return this.container.resolve(definition.gatewayClass);
   }
-  invokeHandler(ws, definition, handlerName, ...args) {
+  async invokeHandler(ws, definition, handlerName, ...args) {
     if (!handlerName) {
       return;
     }
-    const instance = this.getGatewayInstance(definition);
+    const instance = this.createGatewayInstance(definition);
     const handler = instance[handlerName];
-    if (typeof handler === "function") {
+    if (typeof handler !== "function") {
+      return;
+    }
+    const prototype = definition.gatewayClass.prototype;
+    const paramMetadata = getParamMetadata(prototype, handlerName);
+    if (paramMetadata.length > 0) {
+      let context = ws.data?.context;
+      if (!context) {
+        const url = new URL(ws.data.path || "/", "http://localhost");
+        if (ws.data.query) {
+          ws.data.query.forEach((value, key) => {
+            url.searchParams.set(key, value);
+          });
+        }
+        const request = new Request(url.toString(), {
+          method: "GET",
+          headers: new Headers
+        });
+        context = new Context(request);
+        ws.data.context = context;
+      }
+      const boundParams = await ParamBinder.bind(prototype, handlerName, context, this.container);
+      const finalArgs = [];
+      const maxParamIndex = paramMetadata.length > 0 ? Math.max(...paramMetadata.map((m) => m.index)) : -1;
+      const totalParamCount = Math.max(maxParamIndex + 1, args.length + 1);
+      for (let i = 0;i < totalParamCount; i++) {
+        const meta = paramMetadata.find((m) => m.index === i);
+        if (meta) {
+          finalArgs[i] = boundParams[i];
+        } else if (i === 0) {
+          finalArgs[i] = ws;
+        } else {
+          const argIndex = i - 1;
+          if (argIndex < args.length) {
+            finalArgs[i] = args[argIndex];
+          } else {
+            finalArgs[i] = undefined;
+          }
+        }
+      }
+      if (args.length > maxParamIndex) {
+        for (let i = maxParamIndex + 1;i < args.length; i++) {
+          finalArgs.push(args[i]);
+        }
+      }
+      handler.apply(instance, finalArgs);
+    } else {
       handler.apply(instance, [ws, ...args]);
     }
   }
-  handleOpen(ws) {
+  async handleOpen(ws) {
     const path = ws.data?.path;
     const definition = path ? this.getGateway(path) : undefined;
     if (!definition) {
       ws.close(1008, "Gateway not found");
       return;
     }
-    this.invokeHandler(ws, definition, definition.handlers.open);
+    await this.invokeHandler(ws, definition, definition.handlers.open);
   }
-  handleMessage(ws, message) {
+  async handleMessage(ws, message) {
     const path = ws.data?.path;
     const definition = path ? this.getGateway(path) : undefined;
     if (!definition) {
       ws.close(1008, "Gateway not found");
       return;
     }
-    this.invokeHandler(ws, definition, definition.handlers.message, message);
+    await this.invokeHandler(ws, definition, definition.handlers.message, message);
   }
-  handleClose(ws, code, reason) {
+  async handleClose(ws, code, reason) {
     const path = ws.data?.path;
     const definition = path ? this.getGateway(path) : undefined;
     if (!definition) {
       return;
     }
-    this.invokeHandler(ws, definition, definition.handlers.close, code, reason);
+    await this.invokeHandler(ws, definition, definition.handlers.close, code, reason);
   }
 }
 

package/dist/websocket/registry.d.ts

@@ -1,7 +1,10 @@
 import type { ServerWebSocket } from 'bun';
+import { Context } from '../core/context';
 import type { Constructor } from '@/core/types';
 export interface WebSocketConnectionData {
     path: string;
+    query?: URLSearchParams;
+    context?: Context;
 }
 export declare class WebSocketGatewayRegistry {
     private static instance;
@@ -13,10 +16,22 @@ export declare class WebSocketGatewayRegistry {
     hasGateway(path: string): boolean;
     clear(): void;
     private getGateway;
-    private getGatewayInstance;
+    /**
+     * 动态创建网关实例（每次连接创建新实例）
+     * @param definition - 网关定义
+     * @returns 网关实例
+     */
+    private createGatewayInstance;
+    /**
+     * 调用处理器，支持参数绑定
+     * @param ws - WebSocket 连接
+     * @param definition - 网关定义
+     * @param handlerName - 处理器方法名
+     * @param args - 原始参数（message, code, reason 等，不包括 ws）
+     */
     private invokeHandler;
-    handleOpen(ws: ServerWebSocket<WebSocketConnectionData>): void;
-    handleMessage(ws: ServerWebSocket<WebSocketConnectionData>, message: string | ArrayBuffer | ArrayBufferView): void;
-    handleClose(ws: ServerWebSocket<WebSocketConnectionData>, code: number, reason: string): void;
+    handleOpen(ws: ServerWebSocket<WebSocketConnectionData>): Promise<void>;
+    handleMessage(ws: ServerWebSocket<WebSocketConnectionData>, message: string | ArrayBuffer | ArrayBufferView): Promise<void>;
+    handleClose(ws: ServerWebSocket<WebSocketConnectionData>, code: number, reason: string): Promise<void>;
 }
 //# sourceMappingURL=registry.d.ts.map

package/dist/websocket/registry.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/websocket/registry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,KAAK,CAAC;AAK3C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAA;AAa/C,MAAM,WAAW,uBAAuB;IACtC,IAAI,EAAE,MAAM,CAAC;CACd;AAED,qBAAa,wBAAwB;IACnC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAA2B;IAClD,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAY;IACtC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAwC;IAEjE,OAAO;WAIO,WAAW,IAAI,wBAAwB;IAO9C,QAAQ,CAAC,YAAY,EAAE,WAAW,CAAC,OAAO,CAAC,GAAG,IAAI;IAsBlD,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAIjC,KAAK,IAAI,IAAI;IAIpB,OAAO,CAAC,UAAU;IAIlB,OAAO,CAAC,kBAAkB;IAO1B,OAAO,CAAC,aAAa;IAgBd,UAAU,CAAC,EAAE,EAAE,eAAe,CAAC,uBAAuB,CAAC,GAAG,IAAI;IAU9D,aAAa,CAClB,EAAE,EAAE,eAAe,CAAC,uBAAuB,CAAC,EAC5C,OAAO,EAAE,MAAM,GAAG,WAAW,GAAG,eAAe,GAC9C,IAAI;IAUA,WAAW,CAChB,EAAE,EAAE,eAAe,CAAC,uBAAuB,CAAC,EAC5C,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,MAAM,GACb,IAAI;CAQR"}
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/websocket/registry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,KAAK,CAAC;AAO3C,OAAO,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAC;AAC1C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAYhD,MAAM,WAAW,uBAAuB;IACtC,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,eAAe,CAAC;IACxB,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,qBAAa,wBAAwB;IACnC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAA2B;IAClD,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAY;IACtC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAwC;IAEjE,OAAO;WAIO,WAAW,IAAI,wBAAwB;IAO9C,QAAQ,CAAC,YAAY,EAAE,WAAW,CAAC,OAAO,CAAC,GAAG,IAAI;IAsBlD,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAIjC,KAAK,IAAI,IAAI;IAIpB,OAAO,CAAC,UAAU;IAIlB;;;;OAIG;IACH,OAAO,CAAC,qBAAqB;IAI7B;;;;;;OAMG;YACW,aAAa;IAiGd,UAAU,CAAC,EAAE,EAAE,eAAe,CAAC,uBAAuB,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAUvE,aAAa,CACxB,EAAE,EAAE,eAAe,CAAC,uBAAuB,CAAC,EAC5C,OAAO,EAAE,MAAM,GAAG,WAAW,GAAG,eAAe,GAC9C,OAAO,CAAC,IAAI,CAAC;IAUH,WAAW,CACtB,EAAE,EAAE,eAAe,CAAC,uBAAuB,CAAC,EAC5C,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,IAAI,CAAC;CAQjB"}

package/docs/zh/guide.md

@@ -6,7 +6,7 @@
 
 ```ts
 import "reflect-metadata";
-import { Application } from "../src";
+import { Application } from "@dangao/bun-server";
 
 const app = new Application({ port: 3000 });
 app.listen();
@@ -26,7 +26,7 @@ import {
   Injectable,
   Param,
   POST,
-} from "../src";
+} from "@dangao/bun-server";
 
 @Injectable()
 class UserService {
@@ -64,7 +64,7 @@ app.listen();
 ## 3. 使用中间件
 
 ```ts
-import { createCorsMiddleware, createLoggerMiddleware } from "../src";
+import { createCorsMiddleware, createLoggerMiddleware } from "@dangao/bun-server";
 
 const app = new Application();
 app.use(createLoggerMiddleware({ prefix: "[Example]" }));
@@ -74,7 +74,7 @@ app.use(createCorsMiddleware({ origin: "*" }));
 `@UseMiddleware()` 可作用于单个控制器或方法：
 
 ```ts
-import { UseMiddleware } from '../src';
+import { UseMiddleware } from "@dangao/bun-server";
 
 const auth = async (ctx, next) => {
   if (ctx.getHeader('authorization') !== 'token') {
@@ -92,7 +92,7 @@ class SecureController { ... }
 ## 4. 参数验证
 
 ```ts
-import { Validate, IsEmail, MinLength } from '../src';
+import { Validate, IsEmail, MinLength } from "@dangao/bun-server";
 
 @POST('/register')
 public register(
@@ -108,32 +108,37 @@ public register(
 ## 5. WebSocket 网关
 
 ```ts
-import { OnMessage, WebSocketGateway } from "../src";
+import { OnMessage, WebSocketGateway } from "@dangao/bun-server";
+import type { ServerWebSocket } from "bun";
 
-@WebSocketGateway("/ws/chat")
+@WebSocketGateway("/ws")
 class ChatGateway {
   @OnMessage
-  public onMessage(ws, message: string) {
-    ws.send(`echo: ${message}`);
+  public handleMessage(ws: ServerWebSocket, message: string) {
+    ws.send(`Echo: ${message}`);
   }
 }
 
+const app = new Application({ port: 3000 });
 app.registerWebSocketGateway(ChatGateway);
+app.listen();
 ```
 
 ## 6. 文件上传与静态资源
 
 ```ts
-import { createFileUploadMiddleware, createStaticFileMiddleware } from "../src";
+import {
+  createFileUploadMiddleware,
+  createStaticFileMiddleware,
+} from "@dangao/bun-server";
 
+const app = new Application({ port: 3000 });
+
+// File upload
 app.use(createFileUploadMiddleware({ maxSize: 5 * 1024 * 1024 }));
-app.use(
-  createStaticFileMiddleware({
-    root: "./public",
-    prefix: "/assets",
-    enableCache: true,
-  }),
-);
+
+// Static files
+app.use(createStaticFileMiddleware({ root: "./public", prefix: "/assets" }));
 ```
 
 上传后的文件可在 `context.body.files` 中读取；静态资源请求会自动设置
@@ -142,7 +147,7 @@ Content-Type 与缓存头。
 ## 7. 错误处理与自定义过滤器
 
 ```ts
-import { ExceptionFilterRegistry, HttpException } from "../src";
+import { ExceptionFilterRegistry, HttpException } from "@dangao/bun-server";
 
 ExceptionFilterRegistry.getInstance().register({
   catch(error, context) {

package/docs/zh/migration.md

@@ -63,9 +63,15 @@
 
 - 将原本在 `Bun.serve({ websocket })` 中手写的逻辑迁移到 `@WebSocketGateway`：
   ```ts
-  @WebSocketGateway('/ws/chat')
+  import { OnMessage, WebSocketGateway } from "@dangao/bun-server";
+  import type { ServerWebSocket } from "bun";
+
+  @WebSocketGateway('/ws')
   class ChatGateway {
-    @OnMessage onMessage(ws, msg) { ws.send(msg); }
+    @OnMessage
+    public handleMessage(ws: ServerWebSocket, message: string) {
+      ws.send(`Echo: ${message}`);
+    }
   }
   app.registerWebSocketGateway(ChatGateway);
   ```

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dangao/bun-server",
-  "version": "1.5.0",
+  "version": "1.6.0",
   "type": "module",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",

package/src/core/server.ts

@@ -89,8 +89,16 @@ export class BunServer {
           if (!this.options.websocketRegistry.hasGateway(url.pathname)) {
             return new Response("WebSocket gateway not found", { status: 404 });
           }
+          // 创建 Context 以便在 WebSocket 处理器中使用
+          const context = new Context(request);
+          // 创建 Bun 兼容的 URLSearchParams（需要 toJSON 方法）
+          const queryParams = new URLSearchParams(url.searchParams);
           const upgraded = server.upgrade(request, {
-            data: { path: url.pathname },
+            data: {
+              path: url.pathname,
+              query: queryParams,
+              context,
+            },
           });
           if (upgraded) {
             return undefined;
@@ -128,14 +136,14 @@ export class BunServer {
         return responsePromise;
       },
       websocket: {
-        open: (ws) => {
-          this.options.websocketRegistry?.handleOpen(ws);
+        open: async (ws) => {
+          await this.options.websocketRegistry?.handleOpen(ws);
         },
-        message: (ws, message) => {
-          this.options.websocketRegistry?.handleMessage(ws, message);
+        message: async (ws, message) => {
+          await this.options.websocketRegistry?.handleMessage(ws, message);
         },
-        close: (ws, code, reason) => {
-          this.options.websocketRegistry?.handleClose(ws, code, reason);
+        close: async (ws, code, reason) => {
+          await this.options.websocketRegistry?.handleClose(ws, code, reason);
         },
       },
     });

package/src/websocket/registry.ts

@@ -3,7 +3,10 @@ import type { ServerWebSocket } from 'bun';
 import { Container } from '../di/container';
 import { ControllerRegistry } from '../controller/controller';
 import { getGatewayMetadata, getHandlerMetadata } from './decorators';
-import type { Constructor } from '@/core/types'
+import { ParamBinder } from '../controller/param-binder';
+import { getParamMetadata } from '../controller/decorators';
+import { Context } from '../core/context';
+import type { Constructor } from '@/core/types';
 
 interface GatewayDefinition {
   path: string;
@@ -13,11 +16,12 @@ interface GatewayDefinition {
     message?: string;
     close?: string;
   };
-  instance?: unknown;
 }
 
 export interface WebSocketConnectionData {
   path: string;
+  query?: URLSearchParams;
+  context?: Context;
 }
 
 export class WebSocketGatewayRegistry {
@@ -70,63 +74,153 @@ export class WebSocketGatewayRegistry {
     return this.gateways.get(path);
   }
 
-  private getGatewayInstance(definition: GatewayDefinition): unknown {
-    if (!definition.instance) {
-      definition.instance = this.container.resolve(definition.gatewayClass);
-    }
-    return definition.instance;
+  /**
+   * 动态创建网关实例（每次连接创建新实例）
+   * @param definition - 网关定义
+   * @returns 网关实例
+   */
+  private createGatewayInstance(definition: GatewayDefinition): unknown {
+    return this.container.resolve(definition.gatewayClass);
   }
 
-  private invokeHandler(
+  /**
+   * 调用处理器，支持参数绑定
+   * @param ws - WebSocket 连接
+   * @param definition - 网关定义
+   * @param handlerName - 处理器方法名
+   * @param args - 原始参数（message, code, reason 等，不包括 ws）
+   */
+  private async invokeHandler(
     ws: ServerWebSocket<WebSocketConnectionData>,
     definition: GatewayDefinition,
     handlerName: string | undefined,
     ...args: unknown[]
-  ): void {
+  ): Promise<void> {
     if (!handlerName) {
       return;
     }
-    const instance = this.getGatewayInstance(definition);
+
+    // 动态创建实例（每次连接创建新实例）
+    const instance = this.createGatewayInstance(definition);
     const handler = (instance as Record<string, unknown>)[handlerName];
-    if (typeof handler === 'function') {
+
+    if (typeof handler !== 'function') {
+      return;
+    }
+
+    // 获取参数元数据
+    const prototype = definition.gatewayClass.prototype;
+    const paramMetadata = getParamMetadata(prototype, handlerName);
+
+    // 如果有参数装饰器，使用参数绑定
+    if (paramMetadata.length > 0) {
+      // 创建或获取 Context
+      let context = ws.data?.context;
+      if (!context) {
+        // 从 WebSocket 连接数据创建 Context
+        const url = new URL(ws.data.path || '/', 'http://localhost');
+        if (ws.data.query) {
+          ws.data.query.forEach((value, key) => {
+            url.searchParams.set(key, value);
+          });
+        }
+        const request = new Request(url.toString(), {
+          method: 'GET',
+          headers: new Headers(),
+        });
+        context = new Context(request);
+        ws.data.context = context;
+      }
+
+      // 使用 ParamBinder 绑定参数
+      const boundParams = await ParamBinder.bind(
+        prototype,
+        handlerName,
+        context,
+        this.container,
+      );
+
+      // 构建最终参数数组
+      // WebSocket 处理器的参数顺序：ws, [message/code/reason], [装饰器参数...]
+      const finalArgs: unknown[] = [];
+      const maxParamIndex = paramMetadata.length > 0
+        ? Math.max(...paramMetadata.map((m) => m.index))
+        : -1;
+
+      // 按方法签名顺序填充参数
+      // 首先确定方法的总参数数量（包括 ws 和原始参数）
+      const totalParamCount = Math.max(
+        maxParamIndex + 1,
+        args.length + 1, // +1 是 ws 参数
+      );
+
+      for (let i = 0; i < totalParamCount; i++) {
+        const meta = paramMetadata.find((m) => m.index === i);
+        if (meta) {
+          // 使用绑定参数（从 ParamBinder 获取）
+          finalArgs[i] = boundParams[i];
+        } else if (i === 0) {
+          // 第一个参数是 ws
+          finalArgs[i] = ws;
+        } else {
+          // 其他参数是原始参数（message, code, reason 等）
+          const argIndex = i - 1;
+          if (argIndex < args.length) {
+            finalArgs[i] = args[argIndex];
+          } else {
+            finalArgs[i] = undefined;
+          }
+        }
+      }
+
+      // 如果方法签名参数少于实际参数，添加剩余参数
+      if (args.length > maxParamIndex) {
+        for (let i = maxParamIndex + 1; i < args.length; i++) {
+          finalArgs.push(args[i]);
+        }
+      }
+
+      handler.apply(instance, finalArgs);
+    } else {
+      // 没有参数装饰器，直接调用：ws, ...args
       handler.apply(instance, [ws, ...args]);
     }
   }
 
-  public handleOpen(ws: ServerWebSocket<WebSocketConnectionData>): void {
+  public async handleOpen(ws: ServerWebSocket<WebSocketConnectionData>): Promise<void> {
     const path = ws.data?.path;
     const definition = path ? this.getGateway(path) : undefined;
     if (!definition) {
       ws.close(1008, 'Gateway not found');
       return;
     }
-    this.invokeHandler(ws, definition, definition.handlers.open);
+    await this.invokeHandler(ws, definition, definition.handlers.open);
   }
 
-  public handleMessage(
+  public async handleMessage(
     ws: ServerWebSocket<WebSocketConnectionData>,
     message: string | ArrayBuffer | ArrayBufferView,
-  ): void {
+  ): Promise<void> {
     const path = ws.data?.path;
     const definition = path ? this.getGateway(path) : undefined;
     if (!definition) {
       ws.close(1008, 'Gateway not found');
       return;
     }
-    this.invokeHandler(ws, definition, definition.handlers.message, message);
+    await this.invokeHandler(ws, definition, definition.handlers.message, message);
   }
 
-  public handleClose(
+  public async handleClose(
     ws: ServerWebSocket<WebSocketConnectionData>,
     code: number,
     reason: string,
-  ): void {
+  ): Promise<void> {
     const path = ws.data?.path;
     const definition = path ? this.getGateway(path) : undefined;
     if (!definition) {
       return;
     }
-    this.invokeHandler(ws, definition, definition.handlers.close, code, reason);
+    await this.invokeHandler(ws, definition, definition.handlers.close, code, reason);
   }
 }