使用 nextjs 写项目时，用到了 .env 环境变量，这个环境变量是运行时候才需要的。比如 .env 中有 A=1 ，但是在 build 的 Collecting page data 步骤会帮你将 .env 内容替换进代码里帮你检测代码健康。这就导致了一些“有隐患”的代码报错，这里的“有隐患”是相对的，如果部署的时候有 .env 那就不会出问题。
这就造成了一个假象: 这个 .env 内容在 build 阶段就会替换进代码中，而不是运行时。
但在运行时，将 .env A=2 改成 2 之后，代码还是正常获取到 A=2 。
碰到这个问题是因为项目放在 github actions 上使用 docker build nextjs 的项目报错，排查后才发现是 Nexjs 多做了一层“保护“。
 |
1
xavierchow Feb 8, 2025
不太清楚你说的是 nextjs 什么版本，是 pages router 还是 app routers,
但是在 build 阶段，nextjs 会做一些优化比如 SSG(server site generation)，所以你会发现“这个 .env 内容在 build 阶段就会替换进代码中”，我比较建议.env 只在本地开发使用，在 CI （比如 github action)上和部署环境上就不用 .env 文件而是显示指定环境变量， 你可以参考一下我这个项目，可以看到 builder 和 runner 上是分别指定环境变量的。 https://github.com/xavierchow/xblog/blob/ba3e0efcfd42226bee15fb51f45681e752f70a93/Dockerfile#L27-L41 更多的关于 build with docker 的细节另外也可以参考这篇 blog： https://xavierz.dev/blog/posts/xblog_pipeline @FaiChou |
Select Language