ASP.NET Core Web API x86/x64平台适配冲突问题求助

核心矛盾 #

项目同时依赖32位COM DLL和Microsoft.Data.SqlClient，平台位数切换时出现互斥问题：

• 64位进程无法加载32位COM组件
• 32位进程下Microsoft.Data.SqlClient因SNI依赖缺失导致初始化失败

场景复盘 #

场景1：x64目标 + 启用32位应用池 #

• 现象：API启动失败，报错 HTTP Error 500.30 - ASP.NET Core app failed to start，事件日志记录异常代码 0xe0434352
• 原因：x64编译的.NET 6应用强制在32位进程中运行，存在平台不兼容冲突

场景2：x64目标 + 禁用32位应用池 #

• 现象：匿名接口正常返回JSON，但COM组件初始化失败，报错 REGDB_E_CLASSNOTREG (0x80040154)；Basic认证接口正常返回200 OK
• 原因：64位进程无法加载32位COM组件，符合COM跨位数运行的限制

场景3：x86目标 + 启用32位应用池 #

• 现象：匿名接口正常，COM组件初始化成功，但Basic认证接口返回401 Unauthorized，报错 The type initializer for 'Microsoft.Data.SqlClient.TdsParser' threw an exception
• 原因：x86环境下缺失Microsoft.Data.SqlClient对应的SNI（SQL Server Native Interface）依赖组件

解决方案 #

方案1：修复x86环境下的Microsoft.Data.SqlClient依赖 #

Microsoft.Data.SqlClient的SNI依赖需与目标平台严格匹配，x86版本可通过以下方式部署：

1. 确保项目安装的Microsoft.Data.SqlClient版本与.NET 6兼容（推荐使用最新稳定版）
2. 发布时选择自包含部署（Self-Contained），目标运行时指定为win-x86，该模式会自动打包匹配位数的SNI组件
3. 若采用框架依赖部署，需手动提取Microsoft.Data.SqlClient.SNI NuGet包中x86目录下的Microsoft.Data.SqlClient.SNI.x86.dll，复制到应用根目录

方案2：改用System.Data.SqlClient #

若修复SNI依赖存在阻碍，可切换到System.Data.SqlClient：

1. 卸载Microsoft.Data.SqlClient NuGet包，安装System.Data.SqlClient
2. 将代码中的using Microsoft.Data.SqlClient;替换为using System.Data.SqlClient;，相关对象（如SqlConnection、SqlCommand等）API基本兼容，无需大幅修改
3. System.Data.SqlClient依赖系统自带的SQL Server客户端驱动，只要系统安装了对应x86位数的驱动即可正常运行

补充注意事项 #

• 切换到x86平台后，必须将应用池的启用32位应用程序选项设置为True
• 若使用SQL Server身份验证，需确认连接字符串中的用户名、密码正确；若使用Windows身份验证，需确保应用池身份拥有访问目标SQL Server的权限

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