NestJS JWT认证报错：secretOrPrivateKey must have a value 求助

核心问题原因 #

1. 手动注册JwtService导致配置丢失：你在AuthModule的providers数组中手动添加了JwtService，这会覆盖JwtModule.register()自动提供的、已配置好密钥的JwtService实例。手动实例化的JwtService没有传入任何配置参数，因此会触发secretOrPrivateKey must have a value错误。
2. 冗余配置字段冲突：JwtModule.register()中同时配置了secret和secretOrPrivateKey，前者是@nestjs/jwt的标准配置字段，后者是底层jsonwebtoken的参数，重复设置可能导致配置解析异常。

修复步骤 #

1. 移除providers中的JwtService #

修改auth.module.ts，删除providers数组里的JwtService——JwtModule.register()会自动将配置好的JwtService注入到模块中，无需手动注册：

// auth.module.ts 修改后
import { Module } from '@nestjs/common';
import { AuthService } from './auth.service';
import { AuthController } from './auth.controller';
import { EmailService } from 'src/email/email.service';
import { UserService } from 'src/user/user.service';
import { JwtModule } from '@nestjs/jwt';
import { jwtConstants } from './constants';

@Module({
  imports: [
    JwtModule.register({
      global: true,
      secret: jwtConstants.secret,
      signOptions: { expiresIn: '60s' },
    })
  ],
  providers: [AuthService, UserService, EmailService], // 移除JwtService
  controllers: [AuthController]
})
export class AuthModule {}

2. 清理冗余配置字段 #

保留secret字段即可，删除secretOrPrivateKey——@nestjs/jwt会自动将secret传递给底层jsonwebtoken库使用。

3. 确认环境变量加载时机（可选） #

如果使用dotenv加载环境变量，确保在项目入口文件main.ts最顶部先加载配置，避免环境变量未初始化导致的取值问题：

// main.ts
import 'dotenv/config'; // 优先加载环境变量
import { NestFactory } from '@nestjs/core';
import { AppModule } from './app.module';

async function bootstrap() {
  const app = await NestFactory.create(AppModule);
  await app.listen(3000);
}
bootstrap();

验证 #

修改完成后重新启动应用，调用signUp或signIn接口，此时JwtService会使用JwtModule配置的密钥生成Token，错误应该会消失。

内容的提问来源于stack exchange，提问作者Antônio Carlos