Next.js运行next start时如何遵循NODE_ENV加载对应环境配置？

架构老林

2026-8-29

问题根因

next start 是Next.js 设计的生产模式启动命令，框架执行该命令时会强制将进程的NODE_ENV覆写为production，这个是内置硬编码逻辑，无法通过外部传参修改。
该配置加载异常本质是两个常见踩坑点叠加导致的：

常用的config（node-config）库默认优先读取NODE_ENV匹配对应配置文件，而Next.js启动时已经把NODE_ENV锁死为production，自然永远加载production.json5
如果把读取config、填充next.config.js中env对象的逻辑放在构建阶段执行，这部分代码只会在执行next build时运行一次，配置值会被静态硬编码到构建产物里，后续启动时无论改什么环境变量都不会重新读取配置。

推荐标准方案（无需自定义服务器）

完全不需要接入自定义服务器，用node-config原生支持的环境变量即可实现，零侵入无兼容问题：

放弃通过修改NODE_ENV切换配置的思路，不要试图篡改Next.js内置的NODE_ENV逻辑，否则会导致React生产优化、框架缓存、代码压缩等功能异常。
使用node-config官方优先级更高的NODE_CONFIG_ENV变量指定要加载的配置环境，Next.js不会篡改这个自定义环境变量，node-config会优先识别该变量匹配配置文件。
启动命令示例：
```
# 启动预发环境
NODE_CONFIG_ENV=staging next start
# 启动开发环境构建产物（非特殊场景不推荐，本地开发直接用next dev即可）
NODE_CONFIG_ENV=dev next start
# 启动生产环境（和默认逻辑一致）
NODE_CONFIG_ENV=production next start
```
本地开发直接执行next dev即可，框架默认会把NODE_ENV设为development，node-config会自动匹配dev.json5，不需要额外传参。

配置写法修正（避免构建时硬编码）

如果需要实现「一次构建、多环境部署」（同一份build产物通过不同启动参数加载不同环境配置），不要把配置全量写入next.config.js的env字段——这个字段的内容是构建时静态替换到代码里的，构建完成后就无法修改。请按以下规则调整：

仅服务端使用的敏感配置（数据库连接、密钥等）：不要经过next.config.js，直接在服务端代码（API路由、Server Component、getServerSideProps、服务端工具函数）中直接引入config库读取即可，这部分代码运行在next start启动的Node进程中，会正确识别传入的NODE_CONFIG_ENV加载对应配置。

需要暴露给客户端的公开配置：使用Next.js原生的运行时配置字段，这部分内容会在next start启动阶段动态加载，不会被构建时硬编码：

// next.config.js 示例
const config = require('config')
module.exports = {
  // 仅服务端可读取的配置
  serverRuntimeConfig: {
    dbUrl: config.get('db.url'),
    apiSecret: config.get('api.secret')
  },
  // 服务端、客户端均可读取的公开配置
  publicRuntimeConfig: {
    apiBase: config.get('api.baseUrl'),
    staticCdn: config.get('cdn.url')
  }
}

代码中读取配置的方式：

import getConfig from 'next/config'
const { serverRuntimeConfig, publicRuntimeConfig } = getConfig()
// 客户端代码仅能拿到publicRuntimeConfig的内容，不会泄露敏感配置

不推荐方案说明

自定义服务器确实可以绕过Next.js的NODE_ENV限制，但会大幅提升维护成本，丢失Next.js原生的很多性能优化（比如自动静态优化、边缘部署支持等），投入产出比极低，非极端场景不建议使用。

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