ASP.NET Docker构建阶段指定环境变量失效问题求助

我的Dockerfile内容如下：

FROM mcr.microsoft.com/dotnet/sdk:7.0 AS build-env
WORKDIR /app
EXPOSE 80

ARG ASPNETCORE_ENVIRONMENT=Production
ENV ASPNETCORE_ENVIRONMENT=${ASPNETCORE_ENVIRONMENT}

COPY *.csproj ./
RUN dotnet restore

COPY . ./
RUN dotnet publish -c Release -o out

# Build runtime image
FROM mcr.microsoft.com/dotnet/aspnet:7.0
WORKDIR /app
COPY --from=build-env /app/out .
ENTRYPOINT ["dotnet", "OrderAPI.dll"]

我需要在构建阶段就指定.NET运行环境，而不是在容器启动时通过-e ASPNETCORE_ENVIRONMENT参数设置。目前我已经添加了ARG和ENV声明，但执行以下构建命令后，容器仍默认以Production环境运行：

docker build --build-arg ASPNETCORE_ENVIRONMENT=Development -t order-api:latest .

我希望仅通过修改Dockerfile实现需求，不需要额外的shell脚本，同时明确如何处理appsettings相关逻辑。

1. 核心问题：ARG的阶段隔离特性 #

Docker的ARG是阶段级变量，每个构建阶段（即每个FROM指令开启的阶段）相互独立。你之前仅在build-env阶段声明了ARG和ENV，但runtime阶段的镜像没有继承这个变量，导致容器运行时没有设置ASPNETCORE_ENVIRONMENT，最终使用.NET默认的Production环境。

2. 修改Dockerfile让环境变量生效到runtime镜像 #

需要在runtime阶段也声明ARG并设置ENV，确保构建时传入的参数能传递到最终镜像中：

FROM mcr.microsoft.com/dotnet/sdk:7.0 AS build-env
WORKDIR /app
EXPOSE 80

# 构建阶段的ARG与ENV（影响restore、publish过程）
ARG ASPNETCORE_ENVIRONMENT=Production
ENV ASPNETCORE_ENVIRONMENT=${ASPNETCORE_ENVIRONMENT}

COPY *.csproj ./
RUN dotnet restore

COPY . ./
RUN dotnet publish -c Release -o out

# Build runtime image
FROM mcr.microsoft.com/dotnet/aspnet:7.0
WORKDIR /app
# 在runtime阶段重新声明ARG，接收构建时的参数
ARG ASPNETCORE_ENVIRONMENT=Production
# 设置ENV，将变量打包进最终镜像
ENV ASPNETCORE_ENVIRONMENT=${ASPNETCORE_ENVIRONMENT}

COPY --from=build-env /app/out .
ENTRYPOINT ["dotnet", "OrderAPI.dll"]

3. 构建阶段处理appsettings配置 #

如果需要在构建阶段就将对应环境的配置文件打包进镜像（比如替换默认的appsettings.json），可以在build-env阶段添加配置文件复制步骤：

# 在COPY . ./之后、publish之前添加：
COPY appsettings.${ASPNETCORE_ENVIRONMENT}.json ./appsettings.json

这一步需要确保你的项目根目录存在appsettings.Development.json、appsettings.Production.json等对应环境的配置文件，publish时会将这个替换后的appsettings.json打包到输出目录。

4. 验证效果 #

执行构建命令指定环境：

docker build --build-arg ASPNETCORE_ENVIRONMENT=Development -t order-api:latest .

启动容器时无需额外指定环境变量，直接运行：

docker run order-api:latest

此时容器会默认以Development环境运行，且使用对应的配置文件。

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