GitHub Actions无法加载ConfigCat.Client NuGet包问题求助

问题背景 #

• 运行环境：win-2019服务器运行器，.NET SDK 5.0
• 异常现象：解决方案中其余20个NuGet包均可在GitHub Actions正常拉取，仅ConfigCat.Client包加载失败；本地Visual Studio及msbuild命令构建正常，另一个简单解决方案在GitHub Actions中运行无异常
• 核心错误信息：

  C:\Program Files (x86)\Microsoft Visual Studio\2019\Enterprise\MSBuild\Current\Bin\Microsoft.Common.CurrentVersion.targets(2203,5): warning MSB3245: Could not resolve this reference. Could not locate the assembly "ConfigCat.Client, Version=6.5.1.0, Culture=neutral, PublicKeyToken=d28b16a067d7bbe2, processorArchitecture=MSIL". Check to make sure the assembly exists on disk. If this reference is required by your code, you may get compilation errors.
  尝试查找路径D:\a\DataProduction\DataProduction\BigLebowski\packages\ConfigCat.Client.6.5.1\lib\net45\ConfigCat.Client.dll但文件不存在

• 执行的恢复与构建命令：

  msbuild $env:Solution_Path /t:Restore /p:Configuration=$env:Configuration /p:RuntimeIdentifier=$env:RuntimeIdentifier
  msbuild $env:Solution_Path /p:Platform=\"Any CPU\" /p:Configuration=Release /p:UapAppxPackageBuildMode=SideloadOnly /p:AppxBundle=Always /p:PackageCertificateKeyFile=$certificatePath /p:PackageCertificatePassword=${{ secrets.Pfx_Key }}
  

排查与解决建议 #

1. 统一包版本并验证恢复完整性 #

• 日志中同时出现6.5.1和6.5.2两个版本，先检查解决方案内所有项目对ConfigCat.Client的引用版本是否一致，避免版本冲突导致恢复不完整
• 在Restore步骤后添加验证命令，确认包是否正确下载：

  # 查看ConfigCat.Client包的目录结构
  Get-ChildItem -Path "D:\a\DataProduction\DataProduction\BigLebowski\packages\ConfigCat.Client.*" -Recurse
  

• 尝试显式指定包版本执行Restore，强制拉取对应版本：

  msbuild $env:Solution_Path /t:Restore /p:Configuration=Release /p:RuntimeIdentifier=$env:RuntimeIdentifier /p:ConfigCat.ClientVersion=6.5.1
  

2. 检查项目引用的HintPath与目标框架匹配 #

• 打开FeatureFlagService.csproj，查看ConfigCat.Client的引用配置：
  • 日志中查找的是net45目录，但项目使用.NET 5.0，需确认HintPath是否指向正确的目标框架目录（如net5.0）
  • 若使用PackageReference格式，确保未手动指定错误的HintPath；若使用packages.config，检查路径是否与实际恢复的包路径一致

3. 清理NuGet缓存 #

• GitHub Actions的NuGet缓存可能留存了旧的或损坏的包文件，在Restore前添加清理命令：

  nuget locals all -clear
  

• 也可在Workflow中调整缓存策略，比如将包版本加入缓存键，避免缓存过期导致的异常

4. 统一MSBuild命令参数 #

• 当前两次msbuild命令参数不一致：第一次使用$env:Configuration，第二次硬编码为Release；第一次指定了RuntimeIdentifier，第二次未传递
• 调整为参数一致的命令，确保恢复与构建环境统一：

  msbuild $env:Solution_Path /t:Restore /p:Configuration=Release /p:RuntimeIdentifier=$env:RuntimeIdentifier
  msbuild $env:Solution_Path /p:Platform="Any CPU" /p:Configuration=Release /p:RuntimeIdentifier=$env:RuntimeIdentifier /p:UapAppxPackageBuildMode=SideloadOnly /p:AppxBundle=Always /p:PackageCertificateKeyFile=$certificatePath /p:PackageCertificatePassword=${{ secrets.Pfx_Key }}
  

5. 验证包的框架兼容性 #

• 确认ConfigCat.Client 6.5.1/6.5.2版本是否支持.NET 5.0或项目的目标框架，可通过本地NuGet包管理器查看包的支持框架列表
• 若版本不兼容，尝试升级到最新稳定版或降级到已知兼容的版本

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