VS2017中.NET Core 2.0自包含发布System组件版本不匹配求助

这问题我维护.NET Core 2.x项目时亲身碰到过，核心原因是**.NET Core 2.x的依赖解析机制在自包含发布时，容易受全局SDK缓存或间接依赖版本冲突影响，导致发布的程序集版本和.deps.json里的引用版本不匹配**。下面是一步步的解决方法：

1. 强制锁定System.ComponentModel的版本 #

在所有相关项目的.csproj文件中，显式添加对System.ComponentModel 4.3.0的引用，避免依赖解析拉取更高版本：

<ItemGroup>
  <PackageReference Include="System.ComponentModel" Version="4.3.0" PrivateAssets="All" />
</ItemGroup>

PrivateAssets="All"可以确保这个包不会被传递到其他项目，避免版本扩散。

2. 彻底清理缓存（不止NuGet） #

.NET Core 2.x的自包含发布依赖全局的NuGet回退文件夹（NuGetFallbackFolder），如果这个文件夹里有更高版本的System.*包，会优先被复制到发布目录。执行以下命令彻底清理：

# 清理当前项目的bin/obj构建输出
dotnet clean

# 清理本地NuGet缓存
dotnet nuget locals all --clear

# 清理.NET Core SDK的回退缓存（Linux）
rm -rf ~/.dotnet/sdk/NuGetFallbackFolder

# Windows系统请执行这条
# rmdir /s /q %USERPROFILE%\.dotnet\sdk\NuGetFallbackFolder

3. 检查发布命令与项目配置 #

确保发布命令参数正确，自包含发布的完整命令应该是：

dotnet publish -c Release -r linux-x64 --self-contained true

同时检查项目文件里的目标框架和运行时标识是否准确：

<Project Sdk="Microsoft.NET.Sdk.Web"> <!-- 或者对应项目类型的Sdk -->
  <PropertyGroup>
    <TargetFramework>netcoreapp2.0</TargetFramework>
    <RuntimeIdentifier>linux-x64</RuntimeIdentifier>
    <!-- 严格锁定运行时版本，避免SDK自动升级 -->
    <RuntimeFrameworkVersion>2.0.7</RuntimeFrameworkVersion>
  </PropertyGroup>
</Project>

4. 降级/匹配.NET Core SDK版本 #

如果你本地安装了更高版本的.NET Core SDK（比如2.1+），它的NuGet回退文件夹会包含更高版本的System.包，干扰2.0项目的发布。建议安装*.NET Core 2.0.9 SDK**（2.0.x系列的最后一个稳定版本），并确保发布时使用这个版本的SDK：

• 可以通过dotnet --version确认当前使用的SDK版本
• 如果有多个SDK，在项目文件夹下创建global.json文件锁定SDK版本：

{
  "sdk": {
    "version": "2.0.9"
  }
}

问题根源说明 #

.NET Core 2.x的自包含发布机制会从全局的NuGetFallbackFolder复制运行时依赖，而如果你的系统中安装了更高版本的.NET Core SDK（比如2.1及以上），这个文件夹里的System.*包版本会是4.6.2+，发布工具会错误地复制这些高版本包到输出目录，但.deps.json里仍然保留项目指定的4.3.0版本引用，最终导致运行时找不到依赖。

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