Docker构建镜像时NuGet.config读取环境变量失败问题排查

问题根源 #

1. 认证节点不匹配：你的NuGet.config中packageSourceCredentials下的节点名是PackageSTN，但packageSources里私有源的key是MyPrivatePackage，两者必须完全一致，否则NuGet无法将认证信息关联到对应的私有源。
2. 环境变量占位符格式错误：Docker使用的是Linux容器，而你在NuGet.config中用了Windows风格的%NUGET_PAT%占位符，Linux环境下dotnet不会自动解析这种格式的变量，只会把它当成字符串字面量处理，导致认证失败。

修复步骤 #

步骤1：修正NuGet.config的认证节点名称 #

将packageSourceCredentials下的节点名改为和私有源key一致的MyPrivatePackage，修改后的NuGet.config片段：

<packageSourceCredentials>
    <MyPrivatePackage>
        <add key="Username" value="%NUGET_USER%" />
        <add key="ClearTextPassword" value="%NUGET_PAT%" />
        <add key="ValidAuthenticationTypes" value="basic" />
    </MyPrivatePackage>
</packageSourceCredentials>

步骤2：替换环境变量占位符格式（二选一） #

方案A：直接修改NuGet.config为Linux风格变量

将占位符改为Linux环境支持的$NUGET_PAT格式，修改后的认证部分：

<add key="ClearTextPassword" value="$NUGET_PAT" />
<add key="Username" value="$NUGET_USER" />

方案B：在Docker构建时动态替换占位符

如果不想修改原NuGet.config，可以在Dockerfile中添加sed命令替换占位符，修改后的Dockerfile：

FROM mcr.microsoft.com/dotnet/sdk:6.0 AS build
ARG pat_token
ENV NUGET_PAT="${pat_token}"

RUN echo "The ARG variable value is ${pat_token}"
RUN echo "ENV Variable is $NUGET_PAT"

WORKDIR /src
COPY ["NuGet.config", "."]
# 替换NuGet.config中的%NUGET_PAT%为实际环境变量值
RUN sed -i "s/%NUGET_PAT%/$NUGET_PAT/g" NuGet.config
COPY ["MyProjFolder/myproj.csproj", "MyProjFolder/"]
RUN dotnet restore "MyProjFolder/myproj.csproj" -v d

验证 #

重新执行构建命令：

docker build --build-args pat_token=$env:PAT_TOKEN

此时dotnet restore应该能正确读取环境变量完成私有包的认证与还原。

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