SqlConnection的Connection Timeout参数不生效问题咨询

问题说明 #

已在连接字符串中设置Connection Timeout=2，但调用SqlConnection.Open()时，连接失败场景下仍会等待约15秒才返回失败；成功连接时响应正常。

连接字符串 #

<add name="DatabaseServerInstance"
     providerName="Microsoft.Data.SqlClient"
     connectionString="Server=xx.xx.x.xx; Database=db; User Id=user; Password=pass; TrustServerCertificate=true; Connection Timeout=2;" />

测试连接代码 #

public class SqlPusher
{
    private static SqlCommand command = new SqlCommand();
    private static string connectionString = ConfigurationManager.ConnectionStrings["DatabaseServerInstance"].ConnectionString;

    public Boolean TestConnection()
    {
        using (SqlConnection connection = new SqlConnection(connectionString))
        {
            try
            {
                connection.Open();
                return true;
            }
            catch (SqlException)
            {
                return false;
            }
        }
    }
}

原因分析 #

Connection Timeout仅控制TCP连接建立后，与SQL Server的握手、认证阶段超时。如果是TCP连接本身无法建立（比如服务器不可达、端口被防火墙拦截），这个参数不会生效——Windows默认TCP重试机制会导致约15秒的等待时间，这是系统层面的限制，不受SQL客户端参数控制。

解决方法 #

方法1：异步连接+手动超时控制 #

使用OpenAsync配合Task.WhenAny，强制控制总等待时间，覆盖TCP连接和SQL握手的全流程：

修改测试方法为异步版本：

public async Task<bool> TestConnectionAsync()
{
    using (SqlConnection connection = new SqlConnection(connectionString))
    {
        // 同时启动连接任务和超时任务
        var connectTask = connection.OpenAsync();
        var timeoutTask = Task.Delay(TimeSpan.FromSeconds(2));

        // 等待先完成的任务
        var completedTask = await Task.WhenAny(connectTask, timeoutTask);
        
        if (completedTask == timeoutTask)
        {
            // 超时触发，关闭连接并返回失败
            connection.Close();
            return false;
        }

        try
        {
            // 等待连接任务完成，捕获异常
            await connectTask;
            return true;
        }
        catch (SqlException)
        {
            return false;
        }
    }
}

WPF界面调用时，需要在事件处理方法中使用async/await：

private async void TestConnectionBtn_Click(object sender, RoutedEventArgs e)
{
    var pusher = new SqlPusher();
    bool isConnected = await pusher.TestConnectionAsync();
    MessageBox.Show(isConnected ? "连接成功" : "连接失败或超时");
}

方法2：提前检测TCP连通性 #

先检查SQL服务器的端口（默认1433）是否可达，避免进入SQL连接流程后长时间等待：

private async Task<bool> CheckSqlPortAsync(string server, int port = 1433, int timeoutMs = 2000)
{
    using (var tcpClient = new TcpClient())
    {
        var connectTask = tcpClient.ConnectAsync(server, port);
        var timeoutTask = Task.Delay(timeoutMs);

        if (await Task.WhenAny(connectTask, timeoutTask) == timeoutTask)
        {
            return false;
        }

        try
        {
            await connectTask;
            return true;
        }
        catch
        {
            return false;
        }
    }
}

可以在测试连接前调用该方法，TCP不通直接返回失败：

public async Task<bool> TestConnectionAsync()
{
    // 先检查TCP端口
    if (!await CheckSqlPortAsync("xx.xx.x.xx"))
    {
        return false;
    }

    // 再执行SQL连接
    using (SqlConnection connection = new SqlConnection(connectionString))
    {
        try
        {
            await connection.OpenAsync();
            return true;
        }
        catch (SqlException)
        {
            return false;
        }
    }
}

方法3：确认连接字符串参数 #

确保Connection Timeout拼写正确，无多余空格，该参数对Microsoft.Data.SqlClient和旧版System.Data.SqlClient均适用。

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