NestJS 8自定义AuthGuard调用Passport的authenticate报错undefined如何解决

• Nest v8及以上版本对Passport集成做了不兼容变更：PassportModule不再使用passport包的全局默认实例，会独立创建隔离的Passport实例管理策略、序列化逻辑等。你直接从passport包导入的authenticate方法绑定的是未被Nest初始化的全局实例，内部this指向缺失相关属性，调用时就会抛出找不到属性的报错。
• Nest v7版本中PassportModule默认复用全局Passport实例，所以你的代码可以正常运行。

方案1：复用官方封装的AuthGuard（推荐） #

直接继承@nestjs/passport包提供的AuthGuard，官方已经做了实例绑定的兼容处理，无需手动调用authenticate方法：

import { Injectable, ExecutionContext } from '@nestjs/common';
import { AuthGuard } from '@nestjs/passport';

@Injectable()
export class JwtAuthGuard extends AuthGuard('jwt') {
  // 如果需要自定义逻辑，可重写canActivate或handleRequest方法
  canActivate(context: ExecutionContext) {
    // 自定义校验逻辑写在这里
    return super.canActivate(context);
  }
}

如果需要全局启用守卫，你现有AuthModule的APP_GUARD注册逻辑无需修改，把useClass改成你继承后的守卫类即可。

方案2：自定义实现时注入Nest管理的Passport实例 #

如果你确实需要完全自定义守卫逻辑，不要直接导入全局的authenticate方法，改为注入Nest管理的Passport实例后调用实例方法：

import { Inject, Injectable, ExecutionContext, CanActivate } from '@nestjs/common';
import { PASSPORT_INSTANCE } from '@nestjs/passport';
import { Authenticator } from 'passport';

@Injectable()
export class AuthGuard implements CanActivate {
  constructor(@Inject(PASSPORT_INSTANCE) private passport: Authenticator) {}

  canActivate(context: ExecutionContext){
    // ... 你的自定义逻辑
    this.passport.authenticate(...); 
  }
}

注意：请确保你的@nestjs/core、@nestjs/common、@nestjs/passport三个包的大版本号保持一致，避免跨版本兼容问题。

内容的提问来源于stack exchange，提问作者Ondřej Kubíček