NestJS中间件中Passport使用及JwtStrategy认证报错排查

嘿，我来帮你排查下这个JwtStrategy导致的「Unauthenticated」问题！既然已经确认中间件被调用了，那咱们可以从几个常见的使用误区入手检查：

• 先重点检查JwtStrategy里的validate方法：这个方法必须返回有效的用户实体/用户信息对象，如果返回null或者没有正确返回用户数据，Passport（假设你用的是Passport生态）会直接抛出未认证错误。举个正确的示例：

  async validate(payload) {
    const user = await User.findOne({ where: { id: payload.sub } });
    // 务必确保用户存在时才返回，否则主动抛出异常而非返回null
    if (!user) {
      throw new UnauthorizedException();
    }
    return user;
  }
  

• 同时确认JWT的payload解析是否正确：比如sub字段是不是对应你的用户ID，有没有拼写错误或者字段不匹配的情况。

• 检查JwtStrategy构造函数的配置项：有没有正确指定JWT的提取方式？比如从Authorization头的Bearer token提取，以及是否正确设置了签名验证密钥：

  constructor() {
    super({
      jwtFromRequest: ExtractJwt.fromAuthHeaderAsBearerToken(),
      secretOrKey: process.env.JWT_SECRET,
      ignoreExpiration: false, // 除非有特殊需求，否则不要忽略过期校验
    });
  }
  

• 确认请求头的格式是否正确：Authorization头必须是Bearer <你的token>格式，有没有漏掉Bearer前缀？也可以用jwt.io解码token，看看payload是否正确、签名是否有效。

• 检查需要认证的路由：是不是正确应用了对应的认证守卫（比如NestJS里的AuthGuard('jwt')）或者Passport中间件？示例：

  @UseGuards(AuthGuard('jwt'))
  @Get('profile')
  getProfile(@Request() req) {
    return req.user;
  }
  

• 有没有出现“需要认证的路由没加守卫，不需要认证的路由误加守卫”的反向错误？

• 生成JWT时使用的密钥/密钥对，必须和JwtStrategy里的secretOrKey完全一致，否则签名验证不通过会直接触发未认证错误。
• 检查token的过期时间设置：有没有出现token提前过期的情况？比如生成时设置了expiresIn: '10s'，但测试时操作太慢导致token失效。

• 有没有自定义的全局异常过滤器或者其他中间件，提前拦截了请求并抛出了「Unauthenticated」错误？这种情况下，JwtStrategy的验证结果可能被覆盖，导致错误原因被隐藏。

如果以上排查点都没问题，可以把你的JwtStrategy代码片段和路由使用的代码贴出来，这样能更精准定位问题！

内容的提问来源于stack exchange，提问作者Tymur Valiiev