Next.js如何确定NEXT_PUBLIC_BASE_URL的值？本地未配置却自动设为localhost:3000

Next.js核心CLI本身不会自动注入NEXT_PUBLIC_BASE_URL环境变量，出现这个默认值大概率是以下几种场景导致的：

• 第三方依赖或自定义配置注入
  部分第三方API客户端、部署插件，或是你自己在next.config.js的env/publicRuntimeConfig字段、webpack配置中，可能添加了自动注入逻辑，在本地开发环境下默认设置为localhost:3000。检查项目内的配置文件和依赖文档确认。

• 隐性环境文件或系统变量
  除了.env.local，还要排查.env.development、.env等其他环境配置文件，甚至系统级终端环境变量（运行echo $NEXT_PUBLIC_BASE_URL（macOS/Linux）或echo %NEXT_PUBLIC_BASE_URL%（Windows）验证），这些配置可能因加载优先级被应用。

• 自定义代码的兜底逻辑
  查看项目中的工具类、API封装代码，是否存在类似process.env.NEXT_PUBLIC_BASE_URL = process.env.NEXT_PUBLIC_BASE_URL || 'localhost:3000'的兜底赋值，这类代码会在未显式设置变量时自动填充默认值。

• 启动脚本的隐性配置
  检查package.json的scripts字段，比如dev命令是否写成了"dev": "NEXT_PUBLIC_BASE_URL=localhost:3000 next dev"，这类硬编码的启动参数会直接注入环境变量。

快速验证步骤 #

1. 在pages/_app.js（App Router项目则在app/layout.js）中添加console.log('NEXT_PUBLIC_BASE_URL:', process.env.NEXT_PUBLIC_BASE_URL)，启动开发服务器后查看控制台输出。
2. 暂时移除所有.env开头的文件，重启服务器，若变量消失则说明来自环境文件；若仍存在则排查依赖或自定义代码。

内容的提问来源于stack exchange，提问作者aakashgupta.0205