.NET 6 Docker构建阶段设置的环境变量在容器中不可用

你的Dockerfile采用了多阶段构建，各阶段的环境是完全隔离的：

• 你在build阶段设置的ENV environment_env=$environment_arg，仅在build和基于它的publish构建阶段有效，属于构建过程中的临时环境变量。
• 最终运行容器的final阶段是基于base镜像（mcr.microsoft.com/dotnet/aspnet:6.0）从头初始化的，不会自动继承前面阶段的环境变量，所以容器运行时找不到这个变量。

你在build阶段执行的RUN echo能看到变量，只是因为那是在构建过程的build环节中执行的，和最终容器运行环境无关。

以下两种常用方法可以解决这个问题：

方法一：在final阶段重新定义环境变量 #

通过在多个阶段声明相同的ARG，将构建参数传递到final阶段，再设置环境变量：

FROM mcr.microsoft.com/dotnet/aspnet:6.0 AS base
WORKDIR /app
# 全局声明ARG，允许参数传递到后续阶段
ARG environment_arg=Debug

FROM mcr.microsoft.com/dotnet/sdk:6.0 AS build
# 当前阶段声明ARG，接收全局传递的值
ARG environment_arg=Debug
ENV environment_env=$environment_arg

WORKDIR /src
COPY ["PreAdviceGeneration.Presentation/PreAdviceGeneration.Presentation.csproj", "PreAdviceGeneration.Presentation/"]
COPY ["PreAdviceGeneration.Application/PreAdviceGeneration.Application.csproj", "PreAdviceGeneration.Application/"]
COPY ["PreAdviceGeneration.Infrastructure/PreAdviceGeneration.Infrastructure.csproj", "PreAdviceGeneration.Infrastructure/"]
RUN dotnet restore "PreAdviceGeneration.Presentation/PreAdviceGeneration.Presentation.csproj"
COPY . .
WORKDIR "/src/PreAdviceGeneration.Presentation"

RUN dotnet build "PreAdviceGeneration.Presentation.csproj" -c Release -o /app/build

RUN echo "The set environment $environment_env"
RUN echo "The set Argument is $environment_arg"

FROM build AS publish
RUN dotnet publish "PreAdviceGeneration.Presentation.csproj" -c Release -o /app/publish /p:UseAppHost=false

FROM base AS final
WORKDIR /app
# 当前阶段声明ARG，接收全局传递的值
ARG environment_arg=Debug
# 设置环境变量，容器运行时可读取
ENV environment_env=$environment_arg
COPY --from=publish /app/publish .
ENTRYPOINT ["dotnet", "PreAdviceGeneration.Presentation.dll"]

构建和运行命令不变，之后可以通过docker exec pag printenv environment_env验证变量是否存在。

方法二：通过dotnet publish传递环境到应用配置 #

如果是.NET应用的环境配置需求，更推荐直接在发布阶段指定环境参数，让应用自动加载对应配置文件（比如appsettings.Test.json）：
修改publish阶段的命令，添加环境参数：

FROM build AS publish
ARG environment_arg=Debug
RUN dotnet publish "PreAdviceGeneration.Presentation.csproj" -c Release -o /app/publish /p:UseAppHost=false /p:Environment=$environment_arg

这种方式不需要在容器中额外设置环境变量，符合.NET应用的配置最佳实践，应用运行时会自动根据构建时指定的环境加载对应配置。

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