NestJS SocketIO自定义装饰器未在消息处理器中触发

针对你遇到的自定义@SocketContext()装饰器未被调用，但@ConnectedSocket()正常工作的问题，结合重构后出现的背景，给出以下排查方向和解决方案：

1. 检查装饰器的导入与导出 #

• 确认app.gateway.ts中是否正确导入了SocketContext装饰器，检查拼写、大小写是否和定义文件一致，避免因导入错误导致装饰器未生效
• 检查socket-context.decorator.ts中装饰器的导出是否正确，确保是export const SocketContext = ...而非局部定义

2. 验证NestJS包版本兼容性 #

• 重构过程中可能无意中修改了NestJS核心依赖版本，导致createParamDecorator与WS模块的API不兼容。执行npm list @nestjs/common @nestjs/websockets，确保两个包的版本完全一致
• 尝试调整装饰器内的上下文获取逻辑，替换为更明确的类型断言：

  export const SocketContext = createParamDecorator(
    (_: unknown, ctx: ExecutionContext): SocketContextDTO => {
      console.log('INVOKED');
      // 明确指定Socket类型
      const socket = ctx.switchToWs().getClient<TSocket>();
      return createSocketContextDTO(socket);
    },
  );
  

3. 排查全局/网关级别的拦截器/适配器干扰 #

• 重构后新增的全局拦截器、管道或自定义WsAdapter可能破坏了参数装饰器的元数据解析逻辑：
  • 临时移除全局WS相关的拦截器/管道，测试装饰器是否恢复生效
  • 检查网关的@WebSocketGateway配置，是否新增了adapter选项，若有，确认自定义适配器是否正确处理了参数装饰器的元数据

4. 检查TypeScript编译配置 #

• 确认tsconfig.json中以下两个关键配置未被修改为false（这是NestJS装饰器工作的必要条件）：

  {
    "compilerOptions": {
      "experimentalDecorators": true,
      "emitDecoratorMetadata": true
    }
  }
  

5. 清理构建缓存与热重载残留 #

• 删除项目的dist目录，执行npm run build重新编译，避免旧编译文件覆盖新逻辑
• 完全重启服务（而非依赖热重载），确保所有代码模块都被重新加载

快速验证步骤 #

• 在socket-context.decorator.ts的顶层添加console.log('SocketContext decorator file loaded')，确认文件是否被正确加载
• 暂时在网关方法内手动生成SocketContextDTO，验证createSocketContextDTO逻辑本身是否正常：

  async handleRefreshCheck(
    @ConnectedSocket() socket: TSocket,
  ) {
    const ctx = createSocketContextDTO(socket);
    // 后续逻辑保持不变
  }
  

内容的提问来源于stack exchange，提问作者vxm5091