Heroku平台NODE_ENV被设置为development而非production如何处理

配置不生效的常见原因 #

• 根目录存在提交到仓库的 .env 文件：Heroku 读取环境变量时，应用根目录下 .env 文件的优先级高于后台设置的 Config Vars，若该文件内写有 NODE_ENV=development，会直接覆盖你在后台手动添加的配置
• 启动/构建脚本硬编码了环境变量：检查 package.json 内的 scripts 字段，若 start、build 等命令存在显式设置 NODE_ENV=development 的逻辑（例如 "start": "NODE_ENV=development node app.js"），会直接覆盖全局环境变量
• 应用代码内手动重置了变量：检查入口文件（如 app.js、index.js）及框架配置文件，是否存在 process.env.NODE_ENV = 'development' 类的硬编码，部分项目初始化模板会默认添加这段调试逻辑
• 日志工具配置逻辑错误：你可以先在应用入口最顶部添加 console.log('Actual NODE_ENV:', process.env.NODE_ENV)，执行 heroku logs --tail 查看运行时的实际输出，排除 winston 本身的判断逻辑出错的可能

修复操作步骤 #

1. 删除应用根目录下的 .env 文件，同时确认 .gitignore 中已添加 .env 规则，避免后续再将本地环境配置提交到仓库
2. 调整 package.json 中的脚本配置，删除所有硬编码 NODE_ENV=development 的逻辑，标准启动命令示例："start": "node app.js"
3. 清理代码中所有手动修改 process.env.NODE_ENV 的逻辑
4. 重新提交代码部署到 Heroku，部署完成后可执行 heroku run bash 进入应用容器，运行 echo $NODE_ENV 直接验证环境变量的实际值

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