Nextjs build 时候 Collecting page data 的奇怪现象

2025 年 2 月 8 日
 ethusdt

使用 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 多做了一层“保护“。

1794 次点击
所在节点    程序员
1 条回复
xavierchow
2025 年 2 月 8 日
不太清楚你说的是 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

这是一个专为移动设备优化的页面(即为了让你能够在 Google 搜索结果里秒开这个页面),如果你希望参与 V2EX 社区的讨论,你可以继续到 V2EX 上打开本讨论主题的完整版本。

https://www.v2ex.com/t/1109909

V2EX 是创意工作者们的社区,是一个分享自己正在做的有趣事物、交流想法,可以遇见新朋友甚至新机会的地方。

V2EX is a community of developers, designers and creative people.

© 2021 V2EX