类库中SqlConnection连接失败但主应用正常的问题排查

相同的连接字符串与代码在ASP.NET Framework 4.8主应用中（使用System.Data.SqlClient）可正常打开SQL Server连接，但在同时兼容net48和net6.0的类库中（使用Microsoft.Data.SqlClient配合Dapper）调用时，会在Open()处卡顿20秒，反复抛出Microsoft.Data.SqlClient.SqlException，最终提示无法连接SQL Server。

主应用核心代码：

const string connStr = "Data Source=(local);Initial Catalog=DatabaseTest1;Integrated Security=True;MultipleActiveResultSets=True";
var connection = new SqlConnection(connStr);
connection.Open();
connection.Close();

类库依赖的NuGet包：Dapper 2.0.123、Microsoft.Data.SqlClient 5.0.1、Ninject 3.3.6；主应用依赖System.Data 4.0.0.0、EntityFramework 6.4.4等。

尝试过的操作及问题：

• 添加;TrustServerCertificate=True到连接字符串后，抛出System.AccessViolationException；
• 测试控制台应用改为x86平台并手动添加Microsoft.Data.SqlClient.SNI.x64.dll后可连接，但主应用改为x64仍失败；
• 更新连接字符串为：Data Source=(local);Initial Catalog=ActivbaseTest1;Integrated Security=True;MultipleActiveResultSets=True;TrustServerCertificate=True;Encrypt=false，仍连接失败，怀疑是用户身份问题（主应用用应用池账户通过EF可正常连接，希望Dapper使用相同身份）。

1. 统一数据库驱动，消除版本/类型冲突 #

主应用当前使用System.Data.SqlClient，类库使用Microsoft.Data.SqlClient，两者在.NET Framework环境下的SNI加载、身份验证逻辑存在差异，优先统一驱动：

• 给主应用安装与类库同版本的Microsoft.Data.SqlClient（5.0.1）NuGet包，替换原System.Data.SqlClient的引用，确保整个应用栈使用同一驱动；
• 同时安装对应平台的Microsoft.Data.SqlClient.SNI NuGet包（x64/x86），让NuGet自动管理依赖文件，避免手动复制dll导致的版本不匹配或位数错误。

2. 优化连接字符串配置 #

针对.NET Framework下的Microsoft.Data.SqlClient，调整连接字符串参数，避免加密相关异常：

Data Source=(local);Initial Catalog=ActivbaseTest1;Integrated Security=True;MultipleActiveResultSets=True;Encrypt=Optional;TrustServerCertificate=True;

用Encrypt=Optional替代Encrypt=false，更适配驱动的兼容逻辑，减少连接时的加密协商错误。

3. 确认类库运行身份与应用池一致 #

验证类库代码是否在应用池账户上下文执行：

• 在类库的连接代码中添加身份日志：

  var currentIdentity = System.Security.Principal.WindowsIdentity.GetCurrent();
  // 输出currentIdentity.Name到日志，确认是否为应用池账户（如IIS APPPOOL\你的应用池名称）
  

• 如果身份不符，检查Ninject的注入上下文，确保类库实例是在主应用的请求线程中创建，而非独立线程或其他身份上下文。

4. 排查x64平台下的SNI加载问题 #

主应用设为x64平台后，确保SNI依赖文件正确部署：

• 检查Microsoft.Data.SqlClient.SNI.x64 NuGet包的“复制本地”属性为True（右键NuGet包→属性→复制本地）；
• 确认输出目录下存在Microsoft.Data.SqlClient.SNI.x64.dll和snipacket.dll，且版本与Microsoft.Data.SqlClient匹配。

5. 临时禁用连接池排查问题 #

在连接字符串末尾添加Pooling=false，测试是否为连接池导致的异常：

Data Source=(local);Initial Catalog=ActivbaseTest1;Integrated Security=True;MultipleActiveResultSets=True;Encrypt=Optional;TrustServerCertificate=True;Pooling=false

如果禁用后可正常连接，再进一步排查连接池配置（如调整Max Pool Size、Connection Timeout参数）。

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