You need to enable JavaScript to run this app. Ubuntu下Node.js项目package.json配置的NODE_ENV不生效问题
优惠活动
大模型
产品
解决方案
定价
更多

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

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.10.23 14:36:06