.NET 8 API无法连接SQL Server 2022 Express问题排查

问题背景 #

ASP.NET Core 8 Web API连接SQL Server 2022 Express（v16.0.1000）生产实例时，抛出System.InvalidOperationException: Internal connection fatal error异常；本地开发环境（同版本SQL Server、同排序规则Latin1_General_CI_AS）可正常运行，Visual Studio直接连接生产实例也会触发相同错误。SQL Profiler仅捕获到login和logout事件，无额外错误细节，推测问题出在生产SQL Server端。

排查步骤 #

1. 验证TLS/SSL配置兼容性

这是引发"内部连接致命错误"的最常见原因，.NET Core 8默认启用严格的TLS协议，生产SQL Server可能存在配置不匹配：

• 检查生产SQL Server的TLS版本：打开SQL Server配置管理器，依次展开SQL Server网络配置→目标实例的协议→右键TCP/IP→属性，查看标志标签下启用的TLS版本（建议强制启用TLS 1.2或1.3）。
• 临时禁用加密连接测试：在连接字符串中添加Encrypt=false，若能正常连接，说明SSL证书或TLS协商存在问题（注意生产环境不建议长期禁用加密）。
• 强制API使用指定TLS版本：在Program.cs中添加代码，强制应用使用兼容的TLS协议：

System.Net.ServicePointManager.SecurityProtocol = System.Net.SecurityProtocolType.Tls12;

2. 检查登录账户与身份验证配置

• 确认生产SQL Server的身份验证模式：在SSMS中右键实例→属性→安全性，确保选中SQL Server和Windows身份验证模式（若使用SQL账户登录）。
• 检查登录账户的默认数据库权限：部分场景下，登录账户的默认数据库不存在或无连接权限，会导致连接后立即断开。可临时将默认数据库切换为master，并赋予账户该数据库的CONNECT权限测试。
• 尝试Windows身份验证：若使用SQL账户出现问题，改用运行API的服务账户的Windows身份连接，排除账户本身的权限或配置问题。

3. 排查SQL Server网络配置

• 确认TCP/IP协议已启用：在SQL Server配置管理器中，目标实例的TCP/IP协议状态需为已启用。
• 验证端口连通性：在API服务器上执行telnet <生产SQL IP> 1433，确认默认端口未被防火墙拦截；若使用自定义端口，需同步更新连接字符串中的Port参数。
• 检查Named Pipes协议：若连接字符串使用Named Pipes方式，需确认该协议已启用，且API服务账户有访问权限。

4. 查看SQL Server错误日志获取细节

SQL Profiler未捕获到的错误信息，通常会记录在SQL Server的系统日志中：

• 在SSMS中展开实例→管理→SQL Server日志，查看最近的日志条目，寻找连接失败相关的具体错误代码或原因（如SSL握手失败、账户权限不足等）。
• 直接访问服务器上的日志文件：默认路径为C:\Program Files\Microsoft SQL Server\MSSQL16.<实例名>\MSSQL\Log\ERRORLOG，用文本编辑器打开查看。

5. 确认.NET Core SQL驱动版本

• 检查API项目中使用的SQL驱动：建议使用最新稳定版的Microsoft.Data.SqlClient（v5.x及以上），旧版本可能与SQL Server 2022存在兼容性问题。
• 更新NuGet包：在项目中更新Microsoft.Data.SqlClient到最新版本，重新部署后测试连接。

6. 排除排序规则深层冲突

虽然开发环境排序规则一致，但生产环境可能存在局部配置差异：

• 检查数据库级排序规则：部分数据库可能单独设置了与实例不同的排序规则，导致连接时编码冲突。可通过SSMS查看数据库属性中的排序规则，或执行查询：

SELECT name, collation_name FROM sys.databases WHERE name = '<你的数据库名>'

• 测试极简查询：在API中编写仅执行SELECT 1的代码，若连接后执行该查询仍报错，可能与排序规则相关；若连接后立即断开，优先排查前面的TLS、权限或网络问题。

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