Ubuntu 14下NodeJS的process.env无法读取更新后的OPENAI_API_KEY

排查及解决步骤 #

• 重启Node进程：Node启动时仅加载一次.env文件，修改后必须重启服务才能生效。执行killall node终止当前进程，再重新启动项目。
• 确认dotenv加载顺序：把require('dotenv').config()放在项目入口文件（如app.js、index.js）的最顶部，确保在所有引用process.env的代码之前执行，避免部分代码提前读取旧变量。
• 清除系统级环境变量：如果之前通过export OPENAI_API_KEY=旧密钥设置过系统级变量，会覆盖.env文件配置。执行unset OPENAI_API_KEY清除该变量后重启项目。
• 检查.env文件的路径与权限：确认dotenv加载的是你修改的目标.env文件（避免混淆.env.production、.env.development这类多环境文件），同时执行chmod 644 .env赋予文件可读权限。
• 清理进程管理器缓存：如果用PM2、nodemon这类工具，需清除缓存。PM2执行pm2 restart <应用名>或pm2 reload <应用名>；nodemon若忽略了.env修改，调整nodemon.json的watch规则。
• 验证加载结果：在入口文件顶部临时添加console.log(process.env.OPENAI_API_KEY)，启动项目后查看输出，确认是否加载了新密钥，定位加载环节的问题。

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