Docker中dotnet test运行IronPdf时NuGet运行时加载问题求助

在Docker环境中运行dotnet test命令时遇到IronPdf依赖加载异常：

• 项目csproj已显式声明IronPdf.Native.Chrome.Linux/2022.3.5075依赖，但IronPdf运行时仍尝试自动拉取该包
• 环境要求从私有NuGet源获取依赖，因此使用配置了私有源的NuGet.Config，通过--configFile参数在dotnet restore和dotnet build阶段成功从私有源拉取了目标包
• 由于dotnet test不支持--configFile参数，运行时默认尝试从nuget.org拉取依赖，导致加载失败

疑问 #

1. 如何确定运行时加载NuGet包使用的NuGet.Config文件，以及如何配置正确的私有源？
2. 为什么dotnet restore拉取的包未被运行时正常使用？

错误信息 #

Error Message:
IronPdf.Exceptions.IronPdfDeploymentException : Failed downloading NuGet package at runtime from 'https://www.nuget.org/api/v2/package/IronPdf.Native.Chrome.Linux/2022.3.5075'.  Please add 'IronPdf.Native.Chrome.Linux version 2022.3.5075' Nuget package to your .NET project.

csproj配置 #

<PackageReference Include="IronPdf.Linux" Version="2022.3.5084" Condition="$([MSBuild]::IsOsPlatform('Linux'))" />
<PackageReference Include="IronPdf.Native.Chrome.Linux" Version="2022.3.5075" Condition="$([MSBuild]::IsOsPlatform('Linux'))" />

已确认的Restore日志 #

GET https://.../artifactory/api/nuget/v3/nuget-org/registration-semver2/Download/ironpdf.native.chrome.linux/2022.3.5075
GET https://.../artifactory/api/nuget/v3/nuget-org/registration-semver2/Download/ironpdf.linux/2022.3.5084

针对疑问1：运行时NuGet配置定位与私有源设置 #

IronPdf运行时读取NuGet配置的优先级为：

1. 项目根目录下的NuGet.Config
2. 用户主目录下的.nuget/NuGet/NuGet.Config（Linux路径为~/.nuget/NuGet/NuGet.Config）
3. 系统级配置（Linux路径为/etc/opt/NuGet/NuGet.Config）

配置私有源的两种可靠方式：

• 方式一：项目目录放置NuGet.Config
  将包含私有源的配置文件直接放在项目根目录，dotnet test会自动读取，无需命令行参数。示例配置：

  <?xml version="1.0" encoding="utf-8"?>
  <configuration>
    <packageSources>
      <clear /> <!-- 清除默认源，避免优先访问nuget.org -->
      <add key="private-nuget" value="https://.../artifactory/api/nuget/v3/nuget-org" />
    </packageSources>
  </configuration>
  

• 方式二：Docker镜像中配置全局NuGet.Config
  在Dockerfile中添加步骤，将私有源写入全局配置：

  RUN mkdir -p ~/.nuget/NuGet/ && \
      echo '<?xml version="1.0" encoding="utf-8"?><configuration><packageSources><clear /><add key="private-nuget" value="https://.../artifactory/api/nuget/v3/nuget-org" /></packageSources></configuration>' > ~/.nuget/NuGet/NuGet.Config
  

针对疑问2：Restore拉取包未被运行时使用的原因 #

核心原因是IronPdf的运行时动态校验机制：

• 尽管dotnet restore已从私有源拉取依赖，但IronPdf会在运行时检查本地是否存在原生包的二进制文件（如Chrome相关组件）
• 如果检测到文件缺失（可能是构建时未复制到输出目录、Docker打包时遗漏），会触发自动下载逻辑
• 此时它使用的是运行时读取的默认NuGet.Config，而非dotnet restore时指定的临时配置，因此会尝试访问nuget.org导致失败

额外修复步骤：

1. 在csproj中添加配置，强制将原生依赖复制到测试输出目录：

   <ItemGroup Condition="$([MSBuild]::IsOsPlatform('Linux'))">
     <Content Include="$(NuGetPackageRoot)/ironpdf.native.chrome.linux/2022.3.5075/content/**/*">
       <CopyToOutputDirectory>PreserveNewest</CopyToOutputDirectory>
     </Content>
   </ItemGroup>
   

2. Dockerfile中确保dotnet build的输出目录完整复制到测试阶段，避免依赖文件丢失

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