为何参数装饰器在Service中无法被调用？

核心原因 #

TypeScript参数装饰器的执行时机是类定义阶段（代码加载初始化时），而非方法调用时。如果你的装饰器没输出日志，要么是类未被初始化加载，要么是TypeScript配置未启用装饰器支持，或者你误解了装饰器的触发逻辑（以为调用方法时才会执行）。

分步解决 #

1. 检查TypeScript配置 #

确保tsconfig.json中开启了装饰器支持：

{
  "compilerOptions": {
    "experimentalDecorators": true,
    "emitDecoratorMetadata": true // 若需读取元数据则开启
  }
}

2. 验证装饰器是否在类定义阶段执行 #

直接实例化你的Service类，看是否输出日志：

// 在my-service.ts末尾添加
const service = new MyService();

此时控制台应输出Hello from decorator!，说明装饰器已正常执行。

3. 若需在方法调用时触发逻辑 #

参数装饰器本身仅负责添加元数据，要在方法调用时执行逻辑，需配合方法装饰器读取元数据并处理：

步骤1：修改参数装饰器，存储元数据

// my-param.decorator.ts
import 'reflect-metadata';

// 定义唯一元数据键
export const MY_PARAM_META_KEY = Symbol('MY_PARAM');

export function MyParamDecorator(
  target: object,
  propertyKey: string,
  parameterIndex: number,
) {
  console.log('Hello from decorator!');
  // 将参数索引存入元数据
  Reflect.defineMetadata(MY_PARAM_META_KEY, parameterIndex, target, propertyKey);
}

步骤2：创建方法装饰器，读取元数据并处理

// my-method.decorator.ts
import 'reflect-metadata';
import { MY_PARAM_META_KEY } from './my-param.decorator';

export function HandleParam() {
  return function (target: any, propertyKey: string, descriptor: PropertyDescriptor) {
    const originalMethod = descriptor.value;

    // 重写原方法
    descriptor.value = async function (...args: any[]) {
      // 读取参数装饰器存储的元数据
      const paramIndex = Reflect.getMetadata(MY_PARAM_META_KEY, target, propertyKey);
      if (paramIndex !== undefined) {
        const paramValue = args[paramIndex];
        console.log(`处理参数 [索引${paramIndex}]:`, paramValue);
        // 这里可添加自定义逻辑：参数校验、转换等
      }

      // 执行原方法并返回结果
      return originalMethod.apply(this, args);
    };

    return descriptor;
  };
}

步骤3：在Service中配合使用

// my-service.ts
import { MyParamDecorator } from './my-param.decorator';
import { HandleParam } from './my-method.decorator';

class MyService {
  @HandleParam()
  async serviceMethod(@MyParamDecorator query) {
    console.log('Hello from MyService');
    return true;
  }
}

此时调用serviceMethod()时，会先执行方法装饰器中的参数处理逻辑。

4. 若使用NestJS等框架 #

框架自带的参数装饰器（如@Query()）由框架自动处理，自定义参数装饰器需使用框架提供的API，比如NestJS的createParamDecorator：

// my-param.decorator.ts
import { createParamDecorator, ExecutionContext } from '@nestjs/common';

export const MyParamDecorator = createParamDecorator(
  (data: unknown, ctx: ExecutionContext) => {
    console.log('Hello from decorator!');
    const request = ctx.switchToHttp().getRequest();
    // 自定义返回逻辑，比如获取请求参数
    return request.query;
  },
);

这种方式下，框架处理请求时会自动调用该装饰器。

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