Docker运行时无法覆盖Web构建阶段环境变量问题求助

你这问题核心是Web构建阶段把ARG的值硬编码进了构建产物。web_build阶段的ARG ENV1=val1是构建时参数，执行yarn build web时，这个值已经被打包进前端代码里。后续通过docker run -e修改的只是容器系统环境变量，前端构建产物里的val1已经固定，不会再读取运行时的环境变量。

另外你的Dockerfile还有个问题：serve阶段完全没从web_build和api_build阶段复制构建产物，等于启动时可能会重新构建Web应用，而这个重新构建用的是代码默认值，不是你传入的运行时变量。

方案1：让Web应用运行时读取环境变量（推荐） #

如果你的Web应用支持运行时注入环境变量（比如SPA或SSR），调整构建和启动流程，避免构建时硬编码值：

• 删掉web_build阶段的ARG ENV1=val1，构建时不注入该值，在Web代码里改为读取运行时环境变量（浏览器环境需用window.env.xxx，Node环境用process.env.xxx）。
• 修改serve阶段的启动脚本，在启动Web服务前生成一个前端可访问的环境变量文件：

  # serve api
  # ------------------------------------------------
  FROM node:18-bookworm-slim as serve
  
  # 复制web和api的构建产物
  COPY --from=web_build /home/node/app/web/dist /home/node/app/web/dist
  COPY --from=api_build /home/node/app/api /home/node/app/api
  
  ENV ENV1=${ENV1:-val1}
  ENV NODE_ENV=production
  USER node
  WORKDIR /home/node/app
  RUN yarn install --production
  RUN yarn add api-server web-server
  EXPOSE 8910
  # 生成前端环境变量文件并启动服务
  CMD ["sh", "-c", "echo 'window.env = { ENV1: \"$ENV1\" }' > web/dist/env.js && node_modules/.bin/rw-server api & node_modules/.bin/rw-server web"]
  

  之后在Web应用的入口HTML中引入env.js，代码里就能通过window.env.ENV1获取运行时的变量值。

方案2：启动前替换构建产物中的占位符 #

如果必须在构建时使用占位符，可在启动前替换构建产物里的固定值：

• 构建时用占位符代替实际值：

  # web build
  # ------------------------------------------------
  FROM base as web_build
  
  # 用占位符代替具体值
  ARG ENV1=__ENV1__
  RUN yarn build web --no-prerender
  

• 在serve阶段复制构建产物，并在启动前替换占位符：

  # serve api
  # ------------------------------------------------
  FROM node:18-bookworm-slim as serve
  
  COPY --from=web_build /home/node/app/web/dist /home/node/app/web/dist
  COPY --from=api_build /home/node/app/api /home/node/app/api
  
  ENV ENV1=${ENV1:-val1}
  ENV NODE_ENV=production
  USER node
  WORKDIR /home/node/app
  RUN yarn install --production
  RUN yarn add api-server web-server
  EXPOSE 8910
  # 替换构建产物中的占位符后启动服务
  CMD ["sh", "-c", "sed -i 's/__ENV1__/$ENV1/g' web/dist/**/*.js && node_modules/.bin/rw-server api & node_modules/.bin/rw-server web"]
  

  注意：这种方法对压缩后的代码可能失效，需确保构建时占位符不会被代码混淆工具修改。

方案3：动态构建（不推荐） #

如果接受每次启动都重新构建Web应用，可将构建步骤移到serve阶段，但这会破坏镜像缓存，启动速度变慢：

# serve api
# ------------------------------------------------
FROM node:18-bookworm-slim as serve

ENV ENV1=${ENV1:-val1}
ENV NODE_ENV=production
USER node
WORKDIR /home/node/app
COPY . .
RUN yarn install
RUN yarn prisma generate
RUN yarn build web --no-prerender
RUN yarn add api-server web-server
EXPOSE 8910
CMD ["sh", "-c", "node_modules/.bin/rw-server api & node_modules/.bin/rw-server web"]

运行时需用docker run --build-arg ENV1=val2 ...重新构建镜像，本质是构建时传参，并非真正的运行时覆盖。

内容的提问来源于stack exchange，提问作者10raw