使用 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 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 |