.NET 6 Docker构建用CPM时NuGet包被降级求助

• 检查Docker镜像的SDK补丁版本
  微软官方.NET 6 SDK镜像的通用tag（如mcr.microsoft.com/dotnet/sdk:6.0）可能指向较旧的补丁版本，部分旧SDK在处理中央包管理（CPM）时存在逻辑缺陷。建议指定具体的最新补丁tag（如mcr.microsoft.com/dotnet/sdk:6.0.417），避免因SDK版本过旧导致包解析异常。

• 验证中央包管理配置的完整性
  确认根目录下的Directory.Packages.props配置无遗漏：

  • 必须包含开启CPM的核心配置：

    <ManagePackageVersionsCentrally>true</ManagePackageVersionsCentrally>
    

  • Antlr4.Runtime.Standard的版本条目需明确：

    <PackageVersion Include="Antlr4.Runtime.Standard" Version="4.10.1" />
    

  • 所有引用该包的.csproj文件中，不能手动指定版本号，仅保留包引用：

    <PackageReference Include="Antlr4.Runtime.Standard" />
    

  若项目文件中存在手动版本号，会直接覆盖中央配置。

• 追踪依赖链中的强制降级源
  NU1604（依赖版本低于要求）和NU1701（包与目标框架不兼容）警告，说明存在其他依赖包强制引入了Antlr4.Runtime.Standard 4.6.0。在Docker构建步骤中添加命令排查依赖链：

  RUN dotnet list YourProject.csproj package --include-transitive
  

  找到强制依赖旧版本的包后，优先升级该包至兼容4.10.1的版本；若暂时无法升级，可在项目中添加配置阻止降级：

  <PackageReference Include="Antlr4.Runtime.Standard">
    <Version>4.10.1</Version>
    <NoWarn>NU1604,NU1701</NoWarn>
    <AllowDowngrade>false</AllowDowngrade>
  </PackageReference>
  

• 清理Docker构建缓存
  Docker的构建缓存可能残留旧的NuGet包缓存，导致版本解析异常。构建时添加--no-cache参数，或在Dockerfile中添加清理步骤：

  RUN dotnet clean && dotnet restore --no-cache
  

  同时确保dotnet restore使用的NuGet源为官方源，避免镜像内缓存的旧源干扰。

• 确认项目目标框架与RID配置
  检查项目文件中的<TargetFramework>是否明确为net6.0，无多框架混用：

  <TargetFramework>net6.0</TargetFramework>
  

  若指定了RuntimeIdentifier（RID），需与Docker镜像的系统架构一致（如Linux镜像使用linux-x64），避免RID不匹配导致包解析错误。

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