Nest.js环境变量在jwt.strategy.ts中不可见问题排查

开发者阿泽

2026-10-25

问题根因

你现在碰到的环境变量读取失败，本质是模块加载顺序和环境变量初始化顺序错位，具体问题点：

ES模块的导入会被运行时自动提升，哪怕你把dotenv.config()写在main.ts的文件底部，只要你在文件顶部导入了AppModule，Node会先把所有嵌套导入的文件（包括AuthModule、auth.parameters.ts、config.ts）全部执行完，才会走到dotenv.config()那行逻辑。这时候那些文件里写的process.env.XXX被读取时，dotenv还没完成加载，自然拿到的都是undefined。
你现在只有NODE_ENV=local时才会注册ConfigModule，其他运行环境下ConfigModule根本没有被导入，AuthModule里要注入的ConfigService在DI容器里根本不存在，构造函数里拿到的configService就是空值，根本没法调用get()方法读配置。
你写的SecurityParameters是模块导入时就立刻求值的常量，只要这个文件被import，里面的process.env.XXX就会被当场读取。哪怕后面环境变量加载完成，这个常量存的undefined值也不会自动更新，所以硬编码能跑、读env就失效。

修正步骤

把dotenv初始化逻辑挪到所有代码的最顶部
去掉原来main.ts里在文件底部写dotenv.config()的写法，把dotenv的导入和初始化放在main.ts的最第一行，保证它是整个应用第一个执行的代码：

// main.ts 第一行，在所有其他import之前
import * as dotenv from 'dotenv';
dotenv.config();
// 以下再写其他业务代码的导入
import { NestFactory } from '@nestjs/core';
// ... 其余原有bootstrap逻辑保持不变

取消ConfigModule的条件判断，全局注册
不管什么运行环境都要全局引入ConfigModule，保证所有模块都能正常注入ConfigService，不需要额外单独导入：

// app.module.ts 修正后的导入逻辑
@Module({
  imports: [
    UserModule,
    ConfigModule.forRoot({
      isGlobal: true, // 全局生效，所有模块都能直接注入ConfigService
      load: [config],
      // 如果需要按环境加载不同的env文件，在这里通过envFilePath指定即可
    }),
    AuthModule,
  ],
  controllers: [],
  providers: [],
})
export class AppModule {}

注意：Nest内置的ConfigModule本身就会自动加载.env文件，只要正常注册，根本不需要手动调用dotenv.config()也能正常读取环境变量。

避免在模块顶层常量中直接读取环境变量
不要把SecurityParameters写成导入时就求值的固定常量，两种可选改法：
- 所有配置项统一通过注入的ConfigService在构造函数里读取，和你现在读jwksUri的写法保持一致，去掉对SecurityParameters的硬导入依赖。
- 如果一定要集中管理参数，把原来的常量对象改成函数形式，等真正需要使用参数的时候再调用函数读取环境变量，避免模块导入阶段就提前取值：
```
// auth.parameters.ts 修正后的写法
export const getSecurityConfig = () => ({
  issuer: process.env.ISSUER,
  secret: process.env.SECRET,
  expiresIn: process.env.EXPIRESIN,
  jwksUri: process.env.JWKSURI,
  audience: process.env.AUDIENCE,
})
```
确认JwtStrategy已在Nest依赖注入容器中注册
检查AuthModule的providers数组，确保JwtStrategy被列入其中，不然Nest不会自动给它注入ConfigService，构造函数拿到的configService会是undefined。

验证修正的小技巧：可以在JwtStrategy的构造函数第一行加console.log(configService.get('jwksUri'))，重启应用后看控制台是否能正常打印出读取到的值，确认无undefined后再去掉日志即可。

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