Docker部署Next.js时NODE_ENV设为development仍报非标准值错误

可能原因 #

Next.js 抛出这个警告，通常是因为运行时的启动命令与NODE_ENV不匹配，或者构建阶段与运行阶段的NODE_ENV不一致。

具体解决方案 #

1. 确认启动命令对应正确的环境 #

• 如果是开发环境（NODE_ENV=development），必须使用 next dev 启动项目，而非 next start。
  • next start 是为生产构建后的项目设计的，默认期望NODE_ENV=production，强行设置为development会触发非标准值警告。
• 检查你的 Docker 启动命令，确保开发环境下执行的是：

  NODE_ENV=development next dev
  

2. 统一构建与运行阶段的NODE_ENV #

如果你的项目是先构建再部署（比如执行next build后再启动）：

• 构建时的NODE_ENV必须和运行时保持一致。例如开发环境构建：

  NODE_ENV=development next build
  

  之后再用next start启动，此时NODE_ENV也需设为development。

3. 检查环境变量注入时机 #

确保NODE_ENV是在容器启动时就正确注入，而非仅在代码运行时才设置。比如在 Dockerfile 中通过ENV指令设置，或者在 Kubernetes 的部署配置中通过env字段配置。

4. 验证Next.js版本兼容性 #

部分旧版本的Next.js对NODE_ENV的检查逻辑可能存在问题，尝试升级到最新稳定版，看是否能解决该警告。

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