本文详解如何在 Nest.js 中创建可复用的自定义参数装饰器（如 @GetUser），使其在每次 HTTP 请求时动态提取并返回请求上下文中的新鲜值（如用户 ID、路径参数等），避免静态缓存问题。
本文详解如何在 nest.js 中创建可复用的自定义参数装饰器（如 `@getuser`），使其在每次 http 请求时动态提取并返回请求上下文中的新鲜值（如用户 id、路径参数等），避免静态缓存问题。
在 Nest.js 中，自定义参数装饰器必须是函数式、无状态且每次调用都基于当前请求上下文执行的——这与您原始代码中使用 Reflect.defineMetadata 在类定义阶段静态注册装饰器的方式有本质区别。原始写法中 console.log('test', indices) 仅在应用启动时执行一次，无法响应每个请求的动态数据，因此无法获取实时的 id 或其他请求参数。
正确的做法是使用 Nest.js 官方提供的 createParamDecorator 工厂函数。它会为每个被装饰的参数生成一个运行时执行的解析器，接收 ExecutionContext 实例，从而安全访问当前请求对象（req）、响应对象（res）或 WebSocket 客户端等上下文信息。
以下是一个生产就绪的自定义装饰器示例 —— @GetUser，用于从已认证请求的 req.user 中按需提取字段（如 'id' 对应 user.sub）：
// get-user.decorator.ts
import { createParamDecorator, ExecutionContext } from '@nestjs/common';
export const GetUser = createParamDecorator(
(data: string | undefined, ctx: ExecutionContext) => {
const request = ctx.switchToHttp().getRequest();
const user = request.user;
if (!user) return undefined;
if (data === 'id') {
return user.sub; // 常见于 JWT sub 字段
}
return data ? user[data] : user;
},
);✅ 关键点说明：
- createParamDecorator 返回的装饰器会在每次请求进入控制器方法时被调用，确保 request.user 是当前请求的真实实例；
- ctx.switchToHttp().getRequest() 是获取 Express/HTTP 请求对象的标准方式；
- data 参数支持灵活传入字段名（如 'id'、'walletAddress'），提升装饰器复用性；
- 若 request.user 不存在（如未认证），应显式返回 undefined 或抛出异常，避免静默失败。
在控制器中直接使用：
// groups.controller.ts
@Patch(':groupId')
updateGroup(
@Param('groupId') groupId: string, // ✅ Nest 内置：动态解析路径参数
@Body() updateGroupDto: UpdateGroupDto,
@GetUser('id') userId: string, // ✅ 自定义：每次请求取 fresh user.sub
) {
return this.groupsService.updateGroup(groupId, userId, updateGroupDto);
}⚠️ 注意事项：
- 确保 request.user 已由认证守卫（如 JwtAuthGuard）正确赋值，否则 @GetUser 将读取到 undefined；
- 不要在装饰器内部做异步操作（如数据库查询）——参数装饰器必须同步返回值；如需异步逻辑，请改用拦截器或守卫；
- 避免在装饰器中直接修改 request 或共享状态，保持纯函数特性以保证可预测性和可测试性。
通过 createParamDecorator 构建的装饰器，既符合 Nest.js 的依赖注入生命周期设计，又能精准满足“每请求一计算”的业务需求，是构建高内聚、可复用 API 层的最佳实践之一。
