GitLab CI构建.NET项目遇程序集引用解析失败问题求助

问题背景 #

项目包含.NET Core和WCF两个子项目，在GitLab CI搭建了构建流程。安装Newtonsoft.Json 13.0.3后，CI构建触发MSB3245警告，提示无法定位Microsoft.Bcl.AsyncInterfaces、Newtonsoft.Json等程序集。本地环境（包括克隆全新副本、执行与CI完全相同的dotnet build $PROJ_SLN --configuration <configuration>命令）均能正常构建，卸载WCF项目中的Newtonsoft.Json后CI构建恢复正常。

核心原因分析 #

WCF项目基于传统.NET Framework，使用packages.config管理NuGet包，而Newtonsoft.Json 13.0.3针对.NET Framework引入了Microsoft.Bcl.AsyncInterfaces这类较新的依赖，CI环境的NuGet还原策略或版本可能无法正确处理这类跨框架依赖，导致程序集引用路径解析失败。

针对性解决方案 #

1. 降级WCF项目的Newtonsoft.Json版本 #

Newtonsoft.Json 12.0.3版本对传统packages.config项目的依赖处理更稳定，无额外的跨框架依赖。修改WCF项目的packages.config：

<package id="Newtonsoft.Json" version="12.0.3" targetFramework="net4xx" />

本地验证构建正常后，推送代码至CI重新执行构建。

2. 拆分CI中的还原命令 #

针对.NET Core和WCF项目分别执行适配的还原命令，避免混用导致的逻辑冲突：

• 对.NET Core项目执行：dotnet restore <Core项目路径>.csproj
• 对WCF项目单独执行：nuget restore <WCF项目路径>.csproj -PackagesDirectory ./packages
  确保CI脚本中先完成两个项目的还原，再执行dotnet build。

3. 升级CI环境的NuGet版本 #

低版本NuGet可能无法正确解析Newtonsoft.Json 13.0.3的依赖链，在CI脚本开头添加NuGet升级命令：

dotnet tool update --global nuget
nuget --version # 验证版本是否升级至5.x及以上

4. 迁移WCF项目至PackageReference格式 #

将WCF项目的packages.config迁移为PackageReference格式，与.NET Core项目的包管理方式统一，减少CI与本地的还原逻辑差异：

1. 在Visual Studio中右键WCF项目 → 管理NuGet程序包 → 点击右上角的"设置"图标
2. 选择"PackageReference"作为默认包管理格式，迁移现有包引用
3. 推送修改后的代码至CI验证构建

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