Ubuntu下Node.js项目package.json配置的NODE_ENV不生效问题
排查Ubuntu环境下Node.js项目dotenv环境变量不生效的问题
问题根因
- 脚本配置使用了Windows专属的命令语法,和Ubuntu的Shell执行逻辑完全不兼容
你当前写的set NODE_ENV=DEVELOPMENT& nodemon backend/server是Windows CMD的专用写法:set是Windows CMD下用来设置临时环境变量的命令,在Ubuntu默认的bash/zsh环境中,set是Shell内建的状态打印命令,根本不会把变量值注入到后续启动的进程环境里- 用
&分隔命令也是Windows CMD的写法,在Linux Shell中,&的作用是把前面的命令丢到后台运行,不是“完成变量设置后再执行后续命令”的连接符。这套脚本在Ubuntu下执行时,Shell根本没把PRODUCTION这个NODE_ENV值传递给nodemon启动的Node进程
- dotenv加载顺序存在逻辑错误
你在server.js里第一行就引入了./app模块,之后才执行dotenv.config()。如果app内部有提前读取环境变量的逻辑,会直接拿到未定义的空值。另外dotenv的默认运行逻辑是:已经存在于process.env中的环境变量,不会被config.env文件里的值覆盖。因为之前的脚本根本没成功把NODE_ENV写入process.env,所以dotenv加载config.env里写死的NODE_ENV=DEVELOPMENT就直接生效,这就是为什么你执行prod命令时,日志一直显示DEVELOPMENT的核心原因 - 脚本路径书写不规范
你写的nodemon backend/server漏了.js文件后缀,虽然nodemon会自动识别补全,但属于非标准写法,后续更换启动工具时容易出现路径找不到的问题
调整方案
- 替换package.json中的scripts配置,改成Linux Shell兼容的写法,移除Windows专属的set命令和&连接符,使用Shell标准的前置环境变量赋值语法,直接把变量注入到后续启动的进程中。修改后的配置参考:
"scripts": { "start": "node backend/server.js", "dev": "NODE_ENV=DEVELOPMENT nodemon backend/server.js", "prod": "NODE_ENV=PRODUCTION nodemon backend/server.js" } - 调整server.js中的代码执行顺序,把dotenv的加载逻辑放到所有模块引入之前,等环境变量全部就绪后,再引入app模块,避免依赖模块读取环境变量时拿到空值。调整后的开头代码参考:
// 先加载dotenv,确保环境变量完全就绪 const dotenv = require('dotenv') dotenv.config({ path: 'backend/config/config.env' }) // 环境变量加载完成后再引入应用模块 const app = require('./app') app.listen(process.env.PORT, () => { console.log( `Server started on PORT: ${process.env.PORT}. in ${process.env.NODE_ENV}` ) }) - 清理冲突配置
可以直接把config.env里写死的NODE_ENV = DEVELOPMENT这行删除,把NODE_ENV的控制权完全交给启动脚本。这种配置方式下,脚本前置传入的NODE_ENV值会直接存在于process.env中,dotenv加载时不会覆盖已有值,从根源上避免配置冲突。
验证效果
修改完成后执行npm run prod,服务启动日志会正确显示Server started on PORT: 4000. in PRODUCTION,执行npm run dev时则会对应显示DEVELOPMENT值,符合预期效果。
内容的提问来源于stack exchange,提问作者Muamar Humaidi
相关产品推荐
相关产品推荐

