为何AsyncLocalStorage在NestJS守卫canActivate可用却在Passport策略validate失效？

AsyncLocalStorage的核心依赖当前调用栈的异步上下文绑定，只有处于同一异步调用链中的操作才能共享上下文数据，这也是两种模式出现差异的根本原因：

两种模式的执行差异 #

• 第一种模式（JwtAuthGuard的canActivate）：
  NestJS的守卫属于请求处理主流程的一部分，canActivate方法直接在NestJS初始化的AsyncLocalStorage上下文里执行。你在这里设置的clinicId会被后续所有同请求链里的守卫、中间件、控制器共享，因为它们都处于同一个异步上下文绑定中。

• 第二种模式（Passport JWT策略的validate）：
  Passport的策略验证逻辑是在NestJS主请求上下文之外的独立异步分支中执行的：

  1. JwtAuthGuard触发Passport验证后，Passport会创建一个新的异步调用链处理JWT解析与验证；
  2. validate方法执行时，调用栈已经脱离了NestJS最初绑定的AsyncLocalStorage上下文；
  3. 你在validate里设置的userId和clinicId仅存在于这个临时异步分支中，验证流程结束后该分支上下文被销毁，后续AccessGuard回到主上下文自然拿不到这些数据。

解决方案建议 #

方案1：在JwtAuthGuard中传递验证结果到上下文 #

利用canActivate处于正确上下文的特性，在验证完成后从请求对象获取Passport返回的用户数据，再写入AsyncLocalStorage：

// 自定义JwtAuthGuard
async canActivate(context: ExecutionContext): Promise<boolean> {
  // 先完成Passport的基础验证
  const isValid = await super.canActivate(context) as boolean;
  if (!isValid) return false;

  // 获取验证后的用户数据
  const request = context.switchToHttp().getRequest();
  const { userId, clinicId } = request.user;

  // 写入AsyncLocalStorage
  this.contextRequestService.setUserId(userId);
  this.contextRequestService.setClinicId(clinicId);

  return isValid;
}

方案2：手动绑定validate方法到当前上下文 #

通过AsyncLocalStorage.run()方法，将validate的执行逻辑绑定到当前请求的上下文里：

// JWT策略实现
@Injectable()
export class JwtStrategy extends PassportStrategy(Strategy) {
  constructor(
    private readonly als: AsyncLocalStorage<RequestContext>,
    private readonly contextService: ContextRequestService
  ) {
    super({
      jwtFromRequest: ExtractJwt.fromAuthHeaderAsBearerToken(),
      secretOrKey: process.env.JWT_SECRET,
    });
  }

  async validate(payload: any) {
    // 手动绑定当前请求的上下文
    return this.als.run(this.contextService.getContext(), async () => {
      const userId = payload.sub;
      const clinicId = payload.clinicId;
      
      this.contextService.setUserId(userId);
      this.contextService.setClinicId(clinicId);
      
      return { userId, clinicId };
    });
  }
}

注意：需要确保请求进入时已完成上下文的初始化，否则getContext()可能返回空值。

方案3：请求对象中转（备选） #

如果AsyncLocalStorage的上下文绑定遇到边界问题，可以先把userId和clinicId挂到request.user上，再在后续第一个守卫/中间件中将数据写入AsyncLocalStorage，确保数据进入主请求上下文。

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