Node应用使用passport-jwt时，如何从环境变量获取JwtStrategy的secretOrKey值

我之前也碰到过这个一模一样的坑！报错“JwtStrategy requires a secret or key”本质是因为process.env.JWT_SECRET的值是undefined，passport-jwt拿不到有效的密钥才会抛出这个错误。下面是我亲测有效的排查和解决步骤：

一、先确认环境变量是否真的被加载 #

首先要排除“环境变量根本没读进来”这个最常见的问题：

• 在初始化JwtStrategy的代码前，加一行调试打印：

  console.log('当前JWT_SECRET:', process.env.JWT_SECRET);
  

  如果输出是undefined，直接跳到下一步解决环境变量加载问题；如果能输出正确的密钥，那再检查策略的其他配置。

二、确保dotenv（如果用的话）在最开始加载 #

如果你用dotenv包管理本地环境变量：

• 一定要在所有代码执行之前调用dotenv.config()，比如在项目入口文件（比如app.js）的最顶部：

  // 这行必须放在最前面，早于任何其他require
  require('dotenv').config();
  
  const express = require('express');
  const passport = require('passport');
  const { JwtStrategy, ExtractJwt } = require('passport-jwt');
  // ...其他代码
  

• 检查你的.env文件：
  • 必须放在项目根目录，文件名是.env（注意前面的英文点）
  • 格式必须是JWT_SECRET=你的密钥内容，不要加引号，不要在等号前后加空格（比如JWT_SECRET = "mysecret"这种写法会导致变量值带空格和引号，同样会出问题）

三、给密钥加兜底值（临时调试用） #

可以先给secretOrKey加一个硬编码的兜底值，验证JwtStrategy本身的逻辑是否正常：

const jwtOptions = {
  jwtFromRequest: ExtractJwt.fromAuthHeaderAsBearerToken(),
  // 临时用兜底值测试，如果不报错了，说明是环境变量的问题
  secretOrKey: process.env.JWT_SECRET || 'temp_debug_secret_123'
};

如果这样修改后不再报错，那百分百是环境变量加载的问题，回到前面的步骤排查即可。

四、生产环境的特殊注意事项 #

如果是在生产环境（比如Heroku、Vercel、Docker容器等）：

• 不要依赖本地的.env文件，要在平台的环境变量配置面板里添加JWT_SECRET，确保键名和代码里的完全一致（大小写敏感！）
• 如果用Docker，要通过docker run的-e参数或者docker-compose的environment字段传递环境变量。

最后再提一个容易踩的坑 #

如果你把passport的配置放在单独的文件（比如config/passport.js），一定要确保dotenv在这个文件被require之前就已经加载完成。比如不要在passport.js里才调用dotenv.config()，而是在入口文件先加载dotenv，再引入passport配置。

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