.NET Framework 4.7项目CI构建失败：无法解析Serilog.Exceptions引用

云原生阿岚

2026-7-20

解决.NET Framework 4.7应用CI构建中Serilog.Exceptions引用缺失问题

Warning MSB3245: Could not resolve this reference. Could not locate the assembly "Serilog.Exceptions...Check to make sure the assembly exists on disk. If this reference is required by your code, you may get compilation errors.
...
error CS0234: The type or namespace name 'Exceptions' does not exist in the namespace 'Serilog' (are you missing an assembly reference?)

强制CI执行NuGet包还原：本地Visual Studio会自动处理包还原，但CI流水线需要显式配置。在CI脚本中添加包还原步骤，比如使用nuget restore YourSolution.sln，或者在MSBuild命令中加入/t:Restore参数（MSBuild 16.0及以上版本支持），确保Serilog.Exceptions包被下载到CI环境的包缓存中。
确认项目引用类型：检查项目文件（.csproj），确保Serilog.Exceptions是通过NuGet包引用的，而非本地DLL引用。正确的引用节点应为<PackageReference Include="Serilog.Exceptions" Version="对应版本号" />，如果是<Reference Include="Serilog.Exceptions">这类本地DLL引用，CI机器上没有对应文件就会报错。
清理CI环境缓存：CI环境的NuGet缓存可能损坏，导致包无法正常加载。在流水线中添加缓存清理步骤，比如执行nuget locals all -clear清除所有NuGet本地缓存，然后重新执行包还原和构建。
核对目标框架配置：确认CI环境使用的MSBuild版本支持.NET Framework 4.7，同时检查项目文件中的<TargetFrameworkVersion>节点是否为v4.7，避免CI脚本中误将目标框架覆盖为其他版本，导致包兼容性问题。
验证包版本兼容性：确认Serilog.Exceptions的版本与项目中Serilog的版本兼容，且该版本明确支持.NET Framework 4.7。可以在本地更新到兼容版本后，重新提交代码触发CI构建。