Docker 24.0.7 注入的环境变量不生效 构建时和运行时差在哪

后台项目要换接口域名,运维在 docker run 后面加了 -e VITE_API_BASE=https://api.new.com,容器里 env 打印出来是新值,页面刷新后请求还是打向旧域名。三个人的排查方向全跑偏了。

原因在前端构建。源码里写的是 import.meta.env.VITE_API_BASE,vite build 的时候这串会被替换成字面量,产物 JS 里就是硬编码的 https://api.old.com。之后改 .env.production、改 docker run -e、改 k8s 的 env,都动不了已经打好的 dist。grep 一下 dist/assets 里的旧域名,一搜一大片。

Dockerfile 里还有第二层混淆。builder 阶段 ARG API_BASE 加 ENV VITE_API_BASE=$API_BASE,只对 build 阶段可见,docker run 传的 -e 是运行时阶段的事,两者根本不在一个时间线上。多阶段构建里 final 阶段是 nginx,它连 node 都没有。

我最后的做法是运行时注入。容器启动时用一个 sh 脚本把环境变量写成 env.js,index.html 在业务 JS 之前加载它,前端启动先读 window.__ENV__,读不到再退回构建时的默认值。这样换环境不用重新构建镜像。

#!/bin/sh
cat > /usr/share/nginx/html/env.js <<EOF
window.__ENV__ = {
  API_BASE: "${API_BASE}"
};
EOF
exec nginx -g 'daemon off;'

验证方式很直接。docker run -e API_BASE=https://api.test.com 起容器,curl 容器里的 /env.js,值变了、浏览器 Network 里接口域名也变了,才算运行时生效。构建期那套没法这样验,只能去 dist 里 grep 旧域名。

还有个边界:这种方式只适合配置项,别把密钥写进 env.js,那个文件是公开可读的。密钥留在服务端,前端要用的令牌走接口换。

您可以还会对下面的文章感兴趣: