ASP.NET Core调用.NET4.5类库遇System.Data.SqlClient加载异常求助

核心问题原因 #

你遇到的System.Data.SqlClient加载错误，本质是ASP.NET Core（.NET Core/.NET 5+）与.NET Framework 4.5的程序集加载机制不兼容：

• 单独运行项目B时，是在.NET Framework 4.5环境下，能正确加载对应版本的System.Data.SqlClient；
• 启动项目A时，运行环境是.NET Core，它的程序集绑定逻辑和.NET Framework不同，无法找到旧类库依赖的System.Data.SqlClient版本，或者版本匹配失败。

直接让ASP.NET Core项目引用.NET Framework 4.5项目的做法本身就存在兼容性风险，因为两个框架的运行时环境差异较大。

正确的中间层实现方案 #

要让ASP.NET Core通过中间层调用旧类库，需要做以下调整：

1. 明确中间层（项目B）的职责 #

项目B（.NET Framework 4.5）必须做纯封装：

• 仅在项目B内部调用旧类库的API；
• 对外暴露的方法只返回POCO对象（简单实体类），绝对不要返回旧类库特有的类型（比如旧类库的自定义数据类、数据库上下文等）；
• 把所有与旧类库的交互逻辑、异常处理都封装在项目B中，项目A只调用项目B的封装方法。

2. 修复程序集绑定问题 #

在项目A中添加程序集绑定重定向，强制.NET Core环境使用正确版本的System.Data.SqlClient：

• 如果是.NET Core 3.0+项目，在项目根目录创建runtimeconfig.template.json，添加以下内容：

{
  "runtimeOptions": {
    "assemblyBinding": {
      "dependencies": {
        "System.Data.SqlClient": {
          "assemblyVersion": "4.0.0.0",
          "publicKeyToken": "b03f5f7f11d50a3a"
        }
      }
    }
  }
}

• 如果是更早的.NET Core版本，在web.config的<runtime>节点下添加绑定重定向：

<runtime>
  <assemblyBinding xmlns="urn:schemas-microsoft-com:asm.v1">
    <dependentAssembly>
      <assemblyIdentity name="System.Data.SqlClient" publicKeyToken="b03f5f7f11d50a3a" culture="neutral" />
      <bindingRedirect oldVersion="0.0.0.0-4.6.1.0" newVersion="4.6.1.0" />
    </dependentAssembly>
  </assemblyBinding>
</runtime>

3. 确保依赖文件复制完整 #

在项目A对项目B的引用属性中，设置复制本地为True，确保项目B的所有依赖（包括旧类库、System.Data.SqlClient.dll等）都能被复制到项目A的输出目录。
也可以直接在项目A的.csproj文件中添加：

<ItemGroup>
  <ProjectReference Include="..\ProjectB\ProjectB.csproj">
    <Private>True</Private>
  </ProjectReference>
</ItemGroup>

4. 环境限制说明 #

如果旧类库依赖Windows特定功能（比如COM组件、Windows API），项目A必须运行在Windows环境下，.NET Core跨平台模式无法兼容这类依赖。

额外排查技巧 #

• 使用fuslogvw.exe（Windows自带的程序集绑定日志查看器），查看System.Data.SqlClient的加载失败详情，确定是文件缺失还是版本不匹配；
• 检查项目A的输出目录，确认System.Data.SqlClient.dll是否存在，版本是否与项目B中引用的一致。

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