Jenkins+Linux Docker构建.NET多目标框架库遇版本冲突求助

问题背景 #

• 升级目标：将服务从.NET Core 3.1升级至.NET 6
• 实现思路：创建多目标框架（MTF）类库，同时兼容.NET 6与.NET Core 3.1/.NET Standard 2.1
• 构建环境：Linux系统下的Jenkins + Docker
• 现有Dockerfile内容：

FROM mcr.microsoft.com/dotnet/sdk:6.0 as build
copy --FROM=mcr.microsoft.com/dotnet/core/sdk:3.1 /usr/share/dotnet/shared /usr/share/dotnet/shared

• 异常情况：本地构建并使用该类库一切正常，但Jenkins构建的类库在引用时出现版本冲突错误：

Error   CS1705  Assembly '...***...* uses 'System.Runtime, Version=6.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a' which has a higher version than referenced assembly 'System.Runtime' with identity 'System.Runtime, Version=4.2.2.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a'

核心问题分析 #

该错误本质是多目标构建时的程序集版本绑定冲突，本地与Jenkins/Docker环境的差异根源在于：

1. Docker镜像中直接复制共享运行时目录，导致不同版本.NET运行时文件混杂，破坏了官方的版本隔离机制
2. Jenkins构建过程可能未正确配置多目标构建参数，或存在旧构建缓存干扰

解决配置调整方案 #

1. 修正Dockerfile的多SDK安装方式 #

不要直接复制共享目录，改用官方推荐的脚本安装多个.NET SDK版本，保证版本隔离：

FROM mcr.microsoft.com/dotnet/sdk:6.0 as build

# 安装.NET Core 3.1 SDK（使用官方安装脚本）
RUN curl -sSL https://dot.net/v1/dotnet-install.sh | bash /dev/stdin --version 3.1.426 --install-dir /usr/share/dotnet

# 验证SDK安装结果
RUN dotnet --list-sdks

2. 调整Jenkins构建任务配置 #

• 清理构建缓存：在构建步骤中先执行dotnet clean，避免旧版本程序集残留干扰
• 显式指定多目标框架构建：使用明确的构建命令指定目标框架，示例：

dotnet build YourProject.csproj --framework netcoreapp3.1;net6.0 --configuration Release

• 添加版本绑定重定向（临时应急方案）：在项目的.csproj文件中添加配置，强制统一程序集版本：

<PropertyGroup>
  <AutoGenerateBindingRedirects>true</AutoGenerateBindingRedirects>
  <GenerateBindingRedirectsOutputType>true</GenerateBindingRedirectsOutputType>
</PropertyGroup>

<ItemGroup>
  <PackageReference Include="Microsoft.NETCore.Platforms" Version="6.0.0" PrivateAssets="all" />
</ItemGroup>

3. 验证项目文件的多目标配置 #

确保.csproj中的目标框架配置正确，示例：

<Project Sdk="Microsoft.NET.Sdk">
  <PropertyGroup>
    <TargetFrameworks>netcoreapp3.1;net6.0</TargetFrameworks>
  </PropertyGroup>
</Project>

额外排查点 #

• 检查Jenkins代理节点的全局环境变量，确认DOTNET_ROOT未指向错误的.NET版本
• 禁止Docker构建时挂载本地~/.nuget缓存目录，避免旧版本NuGet包影响构建结果

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