构建引用私有NuGet源包的Docker镜像还原失败咨询

错误原因 #

构建抛出NU1102错误的核心逻辑：Docker build阶段执行dotnet restore时仅读取到公共nuget.org源，未加载DevExpress私有NuGet源配置，无法找到未发布到公共源的21.2.8版本DevExtreme.AspNet.Core包。
当前使用的Dockerfile已正确实现复制NuGet.Config到构建工作目录的逻辑，仅需修正NuGet.Config配置即可解决问题。

操作步骤 #

• 打开解决方案根目录（与.sln文件同级）下的NuGet.Config文件，按如下结构修改配置：

<?xml version="1.0" encoding="utf-8"?>
<configuration>
  <packageSources>
    <!-- 保留公共NuGet源，拉取通用.NET依赖包 -->
    <add key="nuget.org" value="https://api.nuget.org/v3/index.json" protocolVersion="3" />
    <!-- 新增DevExpress私有源，value替换为供应商提供的实际私有源地址 -->
    <add key="DevExpress Private Feed" value="替换为DevExpress私有NuGet源实际地址" />
  </packageSources>
  <!-- 私有源需要身份验证时添加该节点，替换为对应账号、访问密钥 -->
  <packageSourceCredentials>
    <DevExpress_20Private_20Feed>
      <add key="Username" value="私有源登录账号" />
      <add key="ClearTextPassword" value="私有源访问密码/专属密钥" />
    </DevExpress_20Private_20Feed>
  </packageSourceCredentials>
</configuration>

• 右键选中项目中的NuGet.Config文件打开属性面板，将复制到输出目录选项设置为「如果较新则复制」，避免Docker构建时复制到过期的配置文件。

排查要点 #

• 私有源的key名称如果包含空格，在packageSourceCredentials节点下对应的子节点名称必须将空格替换为_20（URL编码的空格字符），否则dotnet restore无法匹配对应源的认证信息
• 不要将包含明文账号密码的NuGet.Config提交到公共代码仓库，敏感凭据建议通过Docker构建参数动态传入，避免信息泄露
• 若修改配置后仍报错，可在Dockerfile的dotnet restore命令前添加一行RUN dotnet nuget list source，构建日志会输出当前环境识别到的所有NuGet源，可快速确认源配置是否加载成功
• 确认填写的私有源地址确实托管了21.2.8版本的DevExtreme.AspNet.Core包，排除源地址填写错误问题

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