Docker构建参数未传递给sed，无法生成Node.js的.env文件

这个问题的核心是你没有在Dockerfile的build阶段显式声明对应的构建参数，导致Docker无法识别这些参数，同时sed命令也没法读取到你传递的值。咱们一步步来解决：

1. 修复Dockerfile，声明构建参数 #

Docker的每个构建阶段（FROM ... as ...）是独立的，你通过--build-arg传递的参数不会自动进入build阶段，必须用ARG指令显式声明。修改你的Dockerfile.PROD的build部分：

# build environment
FROM node:12.5.0-alpine as build
# 显式声明需要接收的构建参数
ARG REACT_APP_ACCESS_KEY_ID
ARG REACT_APP_SECRET_ACCESS_KEY
WORKDIR /app
ENV PATH /app/node_modules/.bin:$PATH
COPY package.json ./
COPY package-lock.json ./
COPY DEFAULT.env ./.env
# 注意这里要用双引号包裹sed命令，shell才会解析变量
RUN sed -i "s/access-key/$REACT_APP_ACCESS_KEY_ID/" ./.env
RUN sed -i "s/secret-key/$REACT_APP_SECRET_ACCESS_KEY/" ./.env
RUN npm ci --silent
RUN npm install react-scripts@3.4.1 -g --silent
COPY . ./
RUN npm run build

# production environment
FROM nginx:stable-alpine
COPY --from=build /app/build /usr/share/nginx/html
COPY nginx/nginx.conf /etc/nginx/conf.d/default.conf
EXPOSE 80
CMD ["nginx", "-g", "daemon off;"]

添加ARG指令后，Docker就会识别你传递的构建参数，并且在build阶段的shell环境中可以访问这些变量，sed就能正确完成替换了。

2. 更简洁可靠的.env生成方式（可选） #

如果你的变量名和构建参数名一致，推荐用envsubst工具替换sed，这种方式对多变量场景更易维护：

• 先把DEFAULT.env改成模板文件.env.template：

  REACT_APP_ACCESS_KEY_ID="$REACT_APP_ACCESS_KEY_ID"
  REACT_APP_SECRET_ACCESS_KEY="$REACT_APP_SECRET_ACCESS_KEY"
  

• 然后修改Dockerfile的build阶段：

  # build environment
  FROM node:12.5.0-alpine as build
  ARG REACT_APP_ACCESS_KEY_ID
  ARG REACT_APP_SECRET_ACCESS_KEY
  # 将构建参数转为环境变量，让envsubst能读取到
  ENV REACT_APP_ACCESS_KEY_ID=$REACT_APP_ACCESS_KEY_ID
  ENV REACT_APP_SECRET_ACCESS_KEY=$REACT_APP_SECRET_ACCESS_KEY
  WORKDIR /app
  ENV PATH /app/node_modules/.bin:$PATH
  COPY package.json ./
  COPY package-lock.json ./
  COPY .env.template ./
  # 用envsubst生成最终的.env文件
  RUN envsubst < .env.template > .env
  RUN npm ci --silent
  RUN npm install react-scripts@3.4.1 -g --silent
  COPY . ./
  RUN npm run build
  

3. 验证构建 #

你的构建命令本身没有问题，修改Dockerfile后直接运行原命令即可：

docker build -f Dockerfile.prod --build-arg REACT_APP_ACCESS_KEY_ID=ABCDEFGHZXCV --build-arg REACT_APP_SECRET_ACCESS_KEY=ABCDEFGHZXCVhdhjshdjsdf9889 -t test:prod .

这时候不会再出现One or more build-args were not consumed的警告，.env文件里的变量也会被正确替换。

⚠️ 小提醒：如果这些密钥是敏感信息，构建参数会被记录在镜像的构建历史中，有泄露风险。生产环境中更推荐在容器运行时传递环境变量，或者使用Docker Secrets（Swarm环境）来管理敏感数据。

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