Docker+Angular：AWS CodeBuild下STAGE构建参数执行ng build不生效

这个问题的核心差异是Dockerfile指令的变量解析时机和容器内shell的变量覆盖逻辑导致的，具体如下：

• ENV ENVIRONMENT=$STAGE是Docker原生指令，由Docker守护进程直接处理，变量替换在构建阶段解析指令时就会完成，直接读取你传入的ARG STAGE的值赋值，不涉及容器内部的shell环境，所以取值一直正常。
• RUN ng build --configuration=$STAGE指令的执行逻辑是：Docker先启动一个临时容器，在容器内启动默认shell执行命令，此时变量$STAGE的取值依赖容器内的shell环境。你执行COPY . /app后，如果项目中的配置文件（比如.env、.bashrc、.profile等，这类文件通常在本地被.dockerignore忽略，但是AWS CodeBuild拉取代码或构建过程中会生成/保留）被拷贝进镜像，shell启动时会加载这些配置，如果配置中存在STAGE=的空值赋值，就会把从ARG继承的STAGE变量覆盖为空，导致ng build读取的参数为空。

本地构建正常是因为你本地的开发环境中没有这类会清空STAGE的配置，或者对应文件被.dockerignore规则排除，不会被拷贝进镜像。

按优先级推荐以下方案：

1. 优先补全.dockerignore规则
   在项目根目录的.dockerignore文件中加入不需要拷贝进镜像的文件，避免意外覆盖shell环境变量：

node_modules
.git
.env
.env.*
.DS_Store

2. 使用Docker端变量替换，不依赖容器内shell
   把RUN指令中的变量写法改为${STAGE}，让Docker守护进程在解析指令时就直接替换成ARG的真实值，完全绕过容器内shell的变量覆盖问题：

RUN ng build --configuration=${STAGE} && cp favicon.png dist/

3. 临时排查定位
   如果需要确认变量覆盖的时机，可以在Dockerfile中加入打印日志验证：

# 拷贝代码前打印STAGE值
RUN echo "Before copy STAGE: $STAGE"
COPY . /app
# 拷贝代码后打印STAGE值
RUN echo "After copy STAGE: $STAGE" && ng build --configuration=${STAGE} && cp favicon.png dist/

在AWS CodeBuild中执行构建后查看日志，就能确认是否是拷贝代码操作导致STAGE变量被清空。

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