NestJS中JWTGuard验证正确Token仍返回401未授权问题排查

1. 模块重复注册导致策略冲突 #

你的UserModule中同时导入了AuthModule，又在providers里重复注册了JwtStrategy、AuthService，甚至错误地将PassportModule放在了providers（模块应放在imports中）。AuthModule已经导出了这些核心提供者，重复注册会导致Passport策略实例冲突，JWT验证逻辑无法正常触发。

修复方案：移除UserModule中冗余的提供者配置，修改后的代码如下：

@Module({
  imports: [
    MongooseModule.forFeature([{ name: User.name, schema: UserSchema }]),
    AuthModule, // AuthModule已包含JwtModule、PassportModule及相关策略
  ],
  controllers: [UserController],
  providers: [UserService, PasswordService],
})
export class UserModule { }

2. 确认JwtGuard与策略名称匹配 #

你的JwtStrategy注册时指定了策略名称'jwt'（PassportStrategy(Strategy, 'jwt')），必须确保自定义的JwtGuard使用相同的策略名称。如果你的JwtGuard定义如下，则符合要求：

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

@Injectable()
export class JwtGuard extends AuthGuard('jwt') {}

若Guard使用了其他名称，会找不到对应的验证策略，直接返回401。

3. 验证请求头的Token格式 #

你的JwtStrategy配置了ExtractJwt.fromAuthHeaderAsBearerToken()，要求请求头必须严格遵循格式：

Authorization: Bearer <你的Token>

需确认：

• 未遗漏Bearer前缀
• Bearer与Token之间仅有一个空格
• Token未被截断或添加额外字符

4. 统一JWT模块的Secret配置 #

虽然你检查了.env，但UserModule和AuthModule都单独注册了JwtModule，存在process.env.SECRET加载异常的风险，会导致签名/验证的Secret不匹配。

优化方案：在根模块（如AppModule）全局注册JwtModule，避免重复配置：

JwtModule.register({
  global: true,
  secret: process.env.SECRET,
  signOptions: { expiresIn: '1h' },
})

之后AuthModule和UserModule无需再单独注册JwtModule。

5. 检查Strategy的validate方法是否触发 #

观察JwtStrategy中validate方法的console.log输出：

• 无输出：说明策略未被执行，问题出在Guard或策略注册（如第1点的重复注册问题）
• 有输出：说明Token验证通过，若仍返回401需检查后续权限逻辑（此情况概率极低）

内容的提问来源于stack exchange，提问作者Ahmed Adel