如何将Dockerfile构建时生成的环境变量加载到Node.js进程？方案是否正确？

你的方案整体是正确的，能够实现将构建参数APP_NAME和package.json版本号注入Node.js进程环境的需求，但存在一些可以简化的细节，下面具体分析：

一、当前方案的正确性验证 #

1. 构建参数APP_NAME的传递：在dependencies阶段通过ARG接收构建参数，随后写入docker.env文件并复制到runner阶段，这个流程有效，docker.env中的APP_NAME会正确保留构建时传入的值。
2. package.json版本号的获取：使用node -p "require('./package.json').version"可以准确读取版本号，写入docker.env的方式也没问题。
3. 环境变量注入Node进程：CMD中使用. ./docker.env（即source命令）将环境变量导入当前shell，再通过exec node main.js替换shell进程为Node进程，Node.js可以通过process.env正常获取到PKG_VERSION和APP_NAME，这一步是有效的。

二、可以优化的细节 #

1. 移除无用的RUN cat docker.env：这一步仅在构建阶段打印文件内容，对运行时环境变量注入无任何作用，可直接删除。
2. 简化环境变量文件生成：无需先将APP_NAME设为ENV再写入文件，直接在RUN命令中使用构建参数即可，减少中间步骤：

   # 替换dependencies阶段的ENV和RUN为：
   ARG APP_NAME
   RUN echo "APP_NAME=\"${APP_NAME}\"" > docker.env && \
       echo "PKG_VERSION=\"$(node -p \"require('./package.json').version\")\"" >> docker.env
   

3. 避免中间文件（可选）：如果不想生成docker.env文件，可直接在runner阶段的CMD中动态获取版本号，同时保留APP_NAME的构建参数传递：

   FROM node:20.17-bullseye-slim AS dependencies
   WORKDIR /usr/src/app/test
   COPY package.json ./
   RUN npm install --only=production
   
   FROM node:20.17-bullseye-slim AS runner
   ENV NODE_ENV=production
   WORKDIR /usr/src/app/test
   
   # 在runner阶段接收构建参数并设为环境变量
   ARG APP_NAME
   ENV APP_NAME=${APP_NAME}
   
   COPY --from=dependencies /usr/src/app/test/node_modules ./node_modules
   COPY ./ ./
   
   RUN chown -R node:node .
   USER node
   
   CMD ["/bin/sh", "-c", "export PKG_VERSION=$(node -p \"require('./package.json').version\") && exec node main.js"]
   

三、注意事项 #

• 多阶段构建中，ENV变量不会自动从前面的阶段传递到后续阶段，当前通过写入文件再复制的方式是可靠的；如果采用直接在runner阶段设ENV的方式，需要重新声明ARG。
• 确保构建时package.json的版本号固定，避免构建过程中修改package.json导致版本号不一致。

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