.NET 6升级至.NET 8后dotnet pack兼容性检查失败

问题场景 #

有如下接口定义：

public interface Interface
{
   public string SomeName { get; set;}
   
   [NotRequired]
   public DateTime? SomeDate { get; set; }
}

该类库原本基于.NET 6开发，升级至.NET 8后执行dotnet pack命令验证NuGet包向后兼容性时，触发以下错误：

/Users/joe/.dotnet/sdk/8.0.203/Sdks/Microsoft.NET.Sdk/targets/Microsoft.NET.ApiCompat.ValidatePackage.targets(39,5): error : API compatibility errors between 'lib/net6.0/Some.Interface.dll' (/Users/joe/.nuget/packages/some.interface/2.3.11/some.interface.2.3.11.nupkg) and 'lib/net6.0/Some.Interface.dll'

Member 'System.DateTime Some.Interface.SomeDate.get' exists on [Baseline] lib/net6.0/Some.Interface.dll but not on lib/net6.0/Some.Interfaces.dll

用户确认SomeDate属性未做修改，但工具判定其getter不存在。后续补充：该属性在6个月前从public DateTime SomeDate { get; set; }修改为可空版本，.NET 6、.NET 7的构建流水线从未报错，仅在.NET 8本地执行检查时失败。

问题原因 #

这是.NET 8中ApiCompat工具的检查逻辑优化导致的：

• .NET 6/7版本的ApiCompat对可空值类型属性的兼容性检查存在疏漏：当把非可空DateTime属性改为可空DateTime?时，旧工具没有识别到这是破坏性变更——非可空属性的getter返回System.DateTime，可空版本返回System.DateTime?，二者是完全不同的类型，旧工具未检测到该签名差异。
• .NET 8的ApiCompat修复了这个检查漏洞，严格区分值类型与其可空变体的API签名，因此现在触发了兼容性错误。

解决方案 #

1. 遵循语义化版本规则：如果该类库对外发布，这个修改确实属于破坏性变更（依赖旧版本的代码若直接将SomeDate赋值给DateTime变量会编译失败），需要升级主版本号（比如从2.x.x更新到3.x.x）。
2. 调整兼容性检查配置：如果是内部类库无需严格检查该部分，可以在项目文件中修改配置：
   • 完全禁用ApiCompat检查：

     <PropertyGroup>
       <EnableApiCompat>false</EnableApiCompat>
     </PropertyGroup>
     

   • 仅排除该属性的检查：

     <ItemGroup>
       <ApiCompatSuppressions Include="CP0002" Target="Some.Interface.SomeDate.get" />
     </ItemGroup>
     

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