NestJS动态Controller方法创建问题：@Req/@Res注入失效

需求：针对每个command声明，创建实现逻辑相同但端点不同的接口。

尝试1：复用同一个方法添加多个路由装饰器 #

通用Controller代码：

@Controller()
export class DynamicCommandController {
  handleFunction(@Req() req: FastifyRequest, @Res() response: FastifyReply) {
    console.log(`Handle function...`);
    console.log({ req, response });

    response
      .status(200)
      .header('Content-Type', 'application/json')
      .send({ hello: 'world' });
  }
}

动态注册代码：

const decorators = {
  GET: Get,
  PUT: Put,
  POST: Post,
  PATCH: Patch,
  DELETE: Delete,
};

dynamicCommands.map(({ command }) => {
  const endpointDefintion = command.prototype.endpointDefinition();
  if (!endpointDefintion) {
    return;
  }

  if (this.registeredRoutes.has(endpointDefintion.path)) {
    return;
  }

  const currentDecorator = decorators[endpointDefintion.method];

  if (!currentDecorator) {
    return;
  }

  currentDecorator(endpointDefintion.path)(
    DynamicCommandController.prototype,
    'handleFunction',
    Object.getOwnPropertyDescriptor(
      DynamicCommandController.prototype,
      'handleFunction',
    ),
  );

  this.registeredRoutes.add(endpointDefintion.path);
});

问题：同一个方法无法添加多个@Get（或其他HTTP方法）装饰器，后添加的会覆盖之前的路由配置。

尝试2：动态创建新方法 #

修改后的动态注册代码：

dynamicCommands.map(({ command }) => {
  const endpointDefintion = command.prototype.endpointDefinition();
  if (!endpointDefintion) {
    return;
  }

  if (this.registeredRoutes.has(endpointDefintion.path)) {
    return;
  }

  const currentDecorator = decorators[endpointDefintion.method];

  if (!currentDecorator) {
    return;
  }

  const methodName = `handleFunction_${command.prototype.commandName}${command.prototype.version}`;

  // 动态创建端点对应的新方法
  const dynamicMethod = async function (
    request: FastifyRequest,
    response: FastifyReply,
  ) {
    console.log(`Handle function...`);
    console.log({ request, response });

    response
      .status(200)
      .header('Content-Type', 'application/json')
      .send({ hello: 'world' });
  };

  // 给Controller原型添加方法
  Object.defineProperty(DynamicCommandController.prototype, methodName, {
    value: dynamicMethod,
    writable: true,
    configurable: true,
  });

  applyDecorators(Req)(
    DynamicCommandController.prototype,
    methodName,
    Object.getOwnPropertyDescriptor(
      DynamicCommandController.prototype,
      methodName,
    ),
  );

  currentDecorator(endpointDefintion.path)(
    DynamicCommandController.prototype,
    methodName,
    Object.getOwnPropertyDescriptor(
      DynamicCommandController.prototype,
      methodName,
    ),
  );

  this.registeredRoutes.add(endpointDefintion.path);
});

问题：动态方法创建成功，但request和response参数始终为undefined。

核心问题是**@Req/@Res是参数装饰器，而非方法装饰器**，之前错误地将其当作方法装饰器使用，没有指定参数索引位置，导致Nest无法正确注入请求/响应对象。

Nest的参数装饰器（如@Req()）需要接收三个参数：

1. 目标对象（Controller原型）
2. 方法名
3. 参数的索引位置（第几个参数）

正确的动态注册实现 #

dynamicCommands.map(({ command }) => {
  const endpointDefintion = command.prototype.endpointDefinition();
  if (!endpointDefintion || this.registeredRoutes.has(endpointDefintion.path)) {
    return;
  }

  const currentDecorator = decorators[endpointDefintion.method];
  if (!currentDecorator) {
    return;
  }

  const methodName = `handleFunction_${command.prototype.commandName}${command.prototype.version}`;

  // 定义动态方法
  const dynamicMethod = async function (
    request: FastifyRequest,
    response: FastifyReply,
  ) {
    console.log(`Handle function for ${endpointDefintion.path}`);
    console.log({ request, response });

    response
      .status(200)
      .header('Content-Type', 'application/json')
      .send({ 
        hello: 'world',
        path: endpointDefintion.path
      });
  };

  // 给Controller原型添加方法
  Object.defineProperty(DynamicCommandController.prototype, methodName, {
    value: dynamicMethod,
    writable: true,
    configurable: true,
    enumerable: false,
  });

  // 给第一个参数添加@Req装饰器（索引0）
  Req()(DynamicCommandController.prototype, methodName, 0);
  // 给第二个参数添加@Res装饰器（索引1）
  Res()(DynamicCommandController.prototype, methodName, 1);

  // 添加HTTP路由装饰器
  currentDecorator(endpointDefintion.path)(
    DynamicCommandController.prototype,
    methodName,
    Object.getOwnPropertyDescriptor(DynamicCommandController.prototype, methodName),
  );

  this.registeredRoutes.add(endpointDefintion.path);
});

注意事项：确保装饰器在Nest初始化前完成注册 #

Nest的元数据收集在模块初始化阶段完成，因此需要在模块的register/forRoot方法或onModuleInit钩子之前执行动态注册逻辑。比如封装为动态模块：

@Module({})
export class DynamicCommandModule {
  static register(dynamicCommands: Array<{ command: any }>): DynamicModule {
    const registeredRoutes = new Set<string>();
    const decorators = {
      GET: Get,
      PUT: Put,
      POST: Post,
      PATCH: Patch,
      DELETE: Delete,
    };

    // 执行动态方法注册逻辑
    dynamicCommands.map(({ command }) => {
      // 上面的注册代码
    });

    return {
      module: DynamicCommandModule,
      controllers: [DynamicCommandController],
    };
  }
}

在根模块导入：

@Module({
  imports: [
    DynamicCommandModule.register([/* 你的command列表 */]),
  ],
})
export class AppModule {}

问题根源总结 #

• 尝试1：Nest的HTTP方法装饰器会覆盖同一方法上的旧路由元数据，因此单个方法只能对应一个路由。
• 尝试2：错误地将参数装饰器当作方法装饰器使用，未指定参数索引，导致Nest无法识别需要注入的参数位置。

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