NestJS JwtService报错：secretOrPrivateKey必须有值（非环境变量问题）

核心问题分析 #

你遇到的两个问题本质是同一个：共享模块的JWT配置没有被正确传递到UserService依赖的JwtService实例中。要么是共享模块未正确导出配置好的JWT模块，要么是业务模块未正确导入共享模块，导致要么依赖解析失败，要么拿到未配置密钥的新实例。

分步解决方案 #

1. 修正共享模块的JWT配置与导出

确保共享模块不仅配置JWT，还导出JwtModule，这样其他模块导入后能直接拿到带配置的JwtService实例。

示例共享模块代码：

import { Module } from '@nestjs/common';
import { JwtModule } from '@nestjs/jwt';
import { ConfigService } from '@nestjs/config';

@Module({
  imports: [
    JwtModule.registerAsync({
      useFactory: (configService: ConfigService) => {
        // 这里可以再加一次日志确认密钥加载
        const jwtSecret = configService.get<string>('JWT_SECRET');
        console.log('JWT Secret loaded:', jwtSecret);
        return {
          secret: jwtSecret,
          signOptions: { expiresIn: '1h' }, // 可选配置过期时间
        };
      },
      inject: [ConfigService],
      // 可选：设为全局模块，避免每个业务模块重复导入
      global: true,
    }),
  ],
  // 必须导出JwtModule，否则其他模块无法获取配置好的实例
  exports: [JwtModule],
})
export class SharedModule {}

2. 业务模块正确导入共享模块

在UserService所在的UserModule中，只需导入共享模块，不要将JwtService加入Providers数组（否则会创建未配置的新实例）。

示例UserModule代码：

import { Module } from '@nestjs/common';
import { UserService } from './user.service';
import { UserRepository } from './user.repository';
import { SharedModule } from '../shared/shared.module';

@Module({
  // 关键：导入共享模块，通过共享模块获取配置好的JwtService
  imports: [SharedModule],
  providers: [UserService, UserRepository],
  exports: [UserService],
})
export class UserModule {}

3. UserService直接注入JwtService

此时UserService中直接注入JwtService即可，无需手动传递密钥：

import { Injectable } from '@nestjs/common';
import { JwtService } from '@nestjs/jwt';
import { UserRepository } from './user.repository';

@Injectable()
export class UserService {
  constructor(
    private readonly userRepository: UserRepository,
    private readonly jwtService: JwtService,
  ) {}

  generatePhoneToken(phone: string) {
    // 直接调用sign，自动使用共享模块配置的密钥
    return this.jwtService.sign({ phone });
  }
}

常见错误排查 #

• 若仍提示依赖解析失败：检查UserModule是否正确导入SharedModule，或SharedModule是否在根模块（如AppModule）中导入（如果未设置global: true）。
• 若仍提示密钥缺失：确认useFactory中确实拿到了正确的密钥值，排除配置文件加载顺序或环境变量读取的问题。

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