NestJS自定义Decrypt装饰器未生效：API请求体解密失败排查

问题原因 #

你的问题源于两个核心错误：

1. 参数装饰器叠加使用错误：同时用@Body()和@Decrypt()修饰同一个参数时，NestJS会优先将完整请求体绑定到参数上，直接覆盖@Decrypt()的返回值。
2. 服务实例化不规范：在装饰器中直接new EncryptionService()，不符合NestJS依赖注入规范，虽然当前服务无外部依赖，但不利于后续扩展维护。

此外，从NestJS设计理念来讲，请求体的转换/解密场景更适合用管道（Pipe）实现——管道专门用于数据转换与验证，原生支持依赖注入，是框架推荐的最佳实践。

解决方案 #

方案一：快速修复参数装饰器 #

1. 调整控制器参数装饰器

移除@Body()，因为@Decrypt()已经从请求体中提取并处理数据：

@Post('secure-decrypt-payload')
secureDecryptPayload(@Decrypt() decryptedText: string): string {
  return decryptedText;
}

2. 规范装饰器的依赖注入（可选但推荐）

参数装饰器无法直接注入依赖，可通过ModuleRef获取服务实例，避免直接new：

import { createParamDecorator, ExecutionContext } from '@nestjs/common';
import { EncryptionService } from '../encryption/encryption.service';

export const Decrypt = createParamDecorator(
  async (data: unknown, ctx: ExecutionContext) => {
    const request = ctx.switchToHttp().getRequest();
    const encryptedText = request.body.encryptedText;
    // 通过上下文获取ModuleRef实例，进而拿到EncryptionService
    const moduleRef = ctx.switchToHttp().getContext().moduleRef;
    const encryptionService = await moduleRef.resolve(EncryptionService);
    return encryptionService.decrypt(encryptedText);
  },
);

方案二：改用自定义管道（推荐） #

1. 创建解密管道

import { PipeTransform, Injectable, ArgumentMetadata } from '@nestjs/common';
import { EncryptionService } from './encryption.service';

@Injectable()
export class DecryptPipe implements PipeTransform {
  constructor(private readonly encryptionService: EncryptionService) {}

  transform(value: any, metadata: ArgumentMetadata) {
    // 提取请求体中的encryptedText并解密
    if (value?.encryptedText) {
      return this.encryptionService.decrypt(value.encryptedText);
    }
    return value; // 兼容无encryptedText的请求场景
  }
}

2. 在控制器中应用管道

import { Controller, Post, Body, UsePipes } from '@nestjs/common';
import { EncryptionService } from './encryption.service';
import { DecryptPipe } from './decrypt.pipe';

@Controller('encryption')
export class EncryptionController {
  constructor(private readonly encryptionService: EncryptionService) {}

  @Post('secure-decrypt-payload')
  @UsePipes(DecryptPipe)
  secureDecryptPayload(@Body() decryptedText: string): string {
    return decryptedText;
  }
}

3. 在模块中注册管道

确保模块中声明管道为提供者：

import { Module } from '@nestjs/common';
import { EncryptionController } from './encryption.controller';
import { EncryptionService } from './encryption.service';
import { DecryptPipe } from './decrypt.pipe';

@Module({
  controllers: [EncryptionController],
  providers: [EncryptionService, DecryptPipe],
})
export class EncryptionModule {}

验证 #

用Postman发送原请求后，控制器会返回解密后的文本，而非原请求体内容。

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