Microsoft.Data.SqlClient.SqlException 连接超时时间已到预登录握手失败问题

当你在使用 Microsoft.Data.SqlClient 或 System.Data.SqlClient 连接 SQL Server 时，可能遇到如下错误：

Microsoft.Data.SqlClient.SqlException:“连接超时时间已到。在尝试使用预登录握手确认时超过了此超时时间。这可能是因为预登录握手失败或服务器未能及时响应。尝试连接到此服务器时花费的持续时间是 - [Pre-Login] initialization=xxxx；handshake=yyyy；”。

这个错误指出在建立连接前进行预登录握手期间（Pre-Login Handshake）客户端等待服务器响应超时时。本文将解释错误的含义、常见原因，并提供一系列实用的排查与修复步骤。

错误含义解析

预登录握手 (Pre-Login Handshake)：这是客户端连接 SQL Server 时在真正登录之前进行的一系列准备工作，比如协商加密、协议版本、安全设置等。

initialization 和 handshake 时间指标：错误消息中会包含 initialization=x 和 handshake=y，表示客户端在初始化阶段和握手阶段分别耗时多少毫秒／微秒后请求超时。

连接超时 (Connection Timeout)：指客户端在连接字符串中或默认值设定的时间内未能成功连接并完成预登录握手就放弃请求。默认连接超时时间一般为 15 秒。

可能的根本原因

这些情况可能导致预登录握手失败或响应缓慢，从而触发连接超时错误：

网络延迟或丢包：网络不稳定、VPN /代理 /跨地域连接，或者防火墙／路由器路径上有高延迟或丢包，会导致握手包来回传输时间过长。
端口或协议被阻塞或未启用：SQL Server 未启用 TCP/IP 协议、监听端口（默认 1433）被防火墙阻止；或者 SQL Server Browser 服务未运行导致命名实例无法解析端口。
DNS 解析问题或服务器名称输入错误：使用服务器名称而不是 IP 地址，如果 DNS 或名称解析不稳定，会导致连接延迟或失败。
SSL / 加密协商问题：如果连接字符串或服务器配置强制启用了加密 / 强制证书验证，但证书无效或配置错误，或客户端不支持某些 TLS 版本，握手可能被挂起或失败。
服务器负载过高或资源限制：SQL Server 所在机器资源紧张（CPU / 内存 /并发连接太多 /IO 阻塞），或虚拟机 /云主机环境延迟大。
客户端配置问题：如连接字符串中设置了过短的超时时间、未指定正确的协议、未设置适当的加密选项等。
客户端或服务器补丁 /更新导致的兼容性问题：有用户报告某些 .NET 或 SQL Server 的更新补丁后导致预登录握手失败或响应变慢。

排查与修复步骤

下面是你可以按顺序尝试的解决方案，以排除或修复上述可能原因。

1. 检查服务器是否启动 & 网络协议启用

确保 SQL Server 服务正在运行。

在 SQL Server Configuration Manager 中，确保启用了 TCP/IP 协议。

如果是命名实例，也要确认 SQL Server Browser 服务运行且端口可解析。

2. 确认端口开放 & 防火墙设置

使用 telnet ServerName 1433 或 PowerShell 的 Test-NetConnection 测试端口连通性。

确保服务器防火墙（以及任何网络中间设备）允许入站和出站的 TCP 1433（或你配置的端口）。

3. 使用 IP 地址代替服务器名称测试

如果使用 DNS 名称连接遇到问题，改用服务器的 IP 地址试试，看是否能减少因名称解析导致的延迟。

4. 调整连接字符串参数

增加连接超时（Connection Timeout）：例如将 Connection Timeout=15 改为 30 或更高。

指定 Encrypt=False 与 TrustServerCertificate=True，以减少加密协商过程可能导致的问题（仅在测试环境或你确认安全可控的情况下）。

如果使用 .NET 6 / Microsoft.Data.SqlClient，确认其版本支持你服务器所需的 TLS 或加密协议。

5. 检查 SSL / TLS /证书配置

如果启用了加密连接，确认服务器端 SSL/TLS 证书有效、可信。加强对证书链的检查，确保中间证书也正确安装。

在客户端验证是否支持必需的 TLS 版本（如 TLS 1.2、TLS 1.3），并确认没有被网络设备或组策略强制限制。

6. 分析日志与抓包

在 SQL Server 错误日志中查预登录阶段是否有警告或错误。

客户端侧可开启更高级别的日志记录或使用网络抓包工具（如 Wireshark）看握手包是否发送／接收。

7. 监控服务器负载与资源

检查服务器是否因 CPU、内存或磁盘 I/O 饱和，或是否存在连接数已满的问题。

如果是云主机或虚拟机，确认网络带宽和延迟问题；对延迟敏感的场景考虑将服务器迁移至靠近客户端或更优网络区域。

8. 升级或回滚可能有问题的补丁

若错误在某次系统或 SQL Server 更新后出现，考虑查更新日志看是否有与网络 /TLS /加密相关的补丁。可能升级到最新版本或回滚部分更新能解决问题。

代码示例：如何设置连接字符串与超时

以下是一个示例 .NET 中如何在连接字符串中设置参数以减轻预登录超时问题：

var builder = new SqlConnectionStringBuilder();
builder.DataSource = "your_server_name_or_ip";
builder.InitialCatalog = "your_database";
builder.UserID = "your_user";
builder.Password = "your_password";
builder.Encrypt = false;                       // 禁用 SSL 或临时关闭加密协商
builder.TrustServerCertificate = true;        // 如果证书有问题且你信任
builder.ConnectTimeout = 30;                   // 把超时时间设为 30 秒或更高
// 可选：关闭 Pool 或清理连接池
// builder.Pooling = true;
// builder.MaxPoolSize = 100;

using (var conn = new SqlConnection(builder.ConnectionString))
{
    conn.Open();
    // 执行查询或事务
}

也可以直接在数据库连接字符串里配置：

{
  "ConnectionStrings": {
    "Leavescn": "Server=;Database=;User=;Password=;Connect Timeout=30;Encrypt=Frue;TrustServerCertificate=True;",
  }
}

真实案例与常见场景

有用户在 Azure SQL 或云环境中发现，默认开启加密 +服务器地理位置远 +网络波动大时频繁遇到预登录握手超时问题。降低加密要求或更换到最近的区域有帮助。

本地环境与远程数据库之间穿越 VPN、跳板机或复杂路由时预登录响应慢，增加 ConnectTimeout 并优化网络路径可以减轻问题。

在某些补丁后的 Windows /SQL Server 环境中，TLS 设置被默认更严格，导致客户端某些版本不兼容。更新客户端库或设置兼容 TLS 协议版本通常有效。

小结

预登录握手超时错误通常不是单一原因导致，而是网络、协议、证书或服务器配置等多方面因素的组合。面对 “Connection Timeout Expired… Pre-Login Handshake…” 错误时，建议按以下顺序排查：

网络与端口连通性
SQL Server 协议与服务配置
连接字符串中的超时与加密设置
证书与 SSL/TLS 配置
服务器负载与资源状况
更新与补丁兼容性

通过以上步骤，绝大多数情况下可以定位问题并成功修复。

Microsoft.Data.SqlClient.SqlException 连接超时时间已到 预登录握手失败问题