NestJS(v9) JWT登录报错：secretOrPrivateKey must have a value

问题描述 #

构建NestJS(v9)简易API并实现登录功能，已成功在Docker部署的PostgreSQL中创建用户并完成密码哈希，但调用登录接口http://localhost:3000/users/login时，执行this.jwtService.sign()抛出异常："secretOrPrivateKey must have a value"。当前未使用.env文件，secret为明文配置。

错误日志 #

Password provided by user: testPassword
Hashed password found in database: $2b$10$Y.RV92fRdH0jdUq9etHqaeIHH/1BsN/dzt2McmK1usW8rIgoKZ6Zy
I can see it in the console
[Nest] 30807 - 05/19/2023, 6:26:58 PM ERROR [ExceptionsHandler] secretOrPrivateKey must have a value
Error: secretOrPrivateKey must have a value
at Object.module.exports [as sign]
at JwtService.sign
at AuthService.signIn

排查与修复方案 #

1. 确保JwtModule的配置范围正确 #

你的AuthModule已注册JwtModule，但要保证注入到AuthService的JwtService实例来自已配置secret的模块。如果登录接口所在的控制器被其他模块（如UsersModule）引用，且该模块未导入AuthModule或重复注册了未配置的JwtModule，就会导致JwtService缺少secret配置。

• 确认AuthController属于AuthModule（代码中已满足），且UsersModule未重复注册JwtModule。

2. 修复JwtAuthGuard的依赖注入问题 #

自定义的JwtAuthGuard直接注入了JwtService，若该Guard被其他模块使用，而对应模块未导入AuthModule或JwtModule，会导致JwtService未正确初始化。

方案一：改用官方AuthGuard

替换自定义JwtAuthGuard为Nest官方提供的AuthGuard('jwt')，无需手动处理JWT验证逻辑：

// 在需要授权的控制器/方法上使用
import { UseGuards } from '@nestjs/common';
import { AuthGuard } from '@nestjs/passport';

@UseGuards(AuthGuard('jwt'))

方案二：调整模块导出范围

若要保留自定义Guard，需在AuthModule中导出JwtModule，并在使用Guard的模块导入AuthModule：

// src/auth/auth.module.ts
@Module({
  imports: [
    TypeOrmModule.forFeature([UserEntity]),
    PassportModule.register({ defaultStrategy: 'jwt' }),
    JwtModule.register({
      secret: 'topSecret',
      signOptions: { expiresIn: '24h' },
    }),
    UsersModule,
  ],
  providers: [AuthService, JwtStrategy],
  controllers: [AuthController],
  exports: [AuthService, JwtModule], // 新增导出JwtModule
})
export class AuthModule {}

3. 提前处理用户不存在的潜在问题 #

当前signIn方法在调用jwtService.sign前未判断user是否存在，若数据库无匹配用户，会先触发user.password的读取错误，同时加剧JWT服务的异常风险。修改signIn方法：

// src/auth/auth.service.ts
async signIn(authCredentialsDto: AuthCredentialsDto) {
  const { username, password } = authCredentialsDto;
  const user = await this.userRepository.findOne({ where: { username } });

  // 优先判断用户是否存在
  if (!user) {
    throw new UnauthorizedException('Invalid credentials');
  }

  // 验证密码有效性
  const isPasswordValid = await bcrypt.compare(password, user.password);
  if (!isPasswordValid) {
    throw new UnauthorizedException('Invalid credentials');
  }

  // 验证通过后生成token
  const payload = { username: user.username, sub: user.id };
  const token = this.jwtService.sign(payload);

  return { accessToken: token };
}

4. 检查JwtModule配置的拼写错误 #

确认JwtModule.register中的配置项无拼写错误，比如secret是否误写为secrect，确保'topSecret'是有效字符串。

验证修复步骤 #

1. 重启NestJS服务
2. 调用登录接口，确认是否成功生成JWT Token
3. 使用生成的Token访问需要授权的接口，验证权限控制是否正常

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