NestJS中applyDecorators结合HttpCode与AuthGuard失效问题排查

错误原因 #

@HttpCode() 是方法专属装饰器，仅能用于控制器的路由方法上，无法直接应用在控制器类上。你将它放入 AuthorizedEndpoint 自定义装饰器并作用于控制器类时，HttpCode 装饰器会尝试读取类构造函数的 descriptor.value（这是方法装饰器的逻辑），但类的构造函数不存在该属性，因此触发 Cannot read properties of undefined (reading 'value') 错误。

至于 OpenAccessEndpoint 能正常工作，大概率是你将它应用在了路由方法上（而非类上），方法装饰器可正常执行；而 AuthorizedEndpoint 作用于控制器类，才引发了冲突。

解决方法 #

方案1：拆分装饰器（推荐） #

区分类级与方法级装饰逻辑，创建两个独立的自定义装饰器：

1. 类级装饰器（处理授权逻辑）

export function AuthorizedController(header_key?: string) {
  return applyDecorators(
    UseGuards(AuthGuard),
    ApiBearerAuth(header_key)
  );
}

2. 方法级装饰器（处理响应与Swagger文档）

export function StandardResponse() {
  return applyDecorators(
    HttpCode(200),
    ApiOkResponse({ description: ResponseMessageEnum.R_SUCCESS as string }),
    ApiUnprocessableEntityResponse({ description: ResponseMessageEnum.R_BAD_REQUEST as string }),
    ApiForbiddenResponse({ description: ResponseMessageEnum.R_UNAUTHORIZED as string }),
    ApiNotFoundResponse({ description: ResponseMessageEnum.R_NOT_FOUND as string })
  );
}

3. 控制器中组合使用

@Controller('organization')
@AuthorizedController() // 类级：处理授权校验
export class OrganizationController {
  @Post()
  @StandardResponse() // 方法级：设置响应状态与Swagger文档
  async create() {
    // 业务逻辑代码
  }
}

方案2：全局拦截器统一设置状态码 #

如果需要给所有POST请求统一返回200状态码，可使用NestJS拦截器实现：

@Injectable()
export class SetPostHttpCodeInterceptor implements NestInterceptor {
  intercept(context: ExecutionContext, next: CallHandler): Observable<any> {
    const request = context.switchToHttp().getRequest();
    if (request.method === 'POST') {
      context.switchToHttp().getResponse().status(200);
    }
    return next.handle();
  }
}

在模块中全局注册拦截器：

@Module({
  providers: [
    {
      provide: APP_INTERCEPTOR,
      useClass: SetPostHttpCodeInterceptor,
    },
  ],
})
export class AppModule {}

或者仅在目标控制器上使用：

@Controller('organization')
@UseInterceptors(SetPostHttpCodeInterceptor)
@AuthorizedController()
export class OrganizationController {
  // ...
}

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