C#与SQL Server的组合是.NET开发中最常见的数据库访问方案，无论是WinForm桌面程序、ASP.NET网站还是后台服务，几乎都绕不开与数据库打交道这件事。很多初学者照着教程写了连接代码，却经常遇到连接超时、连接未关闭、连接池耗尽等问题，排查起来毫无头绪。这篇文章从基础的连接写法讲起，再深入分析连接超时的成因和解决方案，帮你把数据库连接这一层彻底搞明白。
一、使用SqlConnection连接SQL Server的基础写法
ADO.NET是.NET平台访问数据库的核心框架，连接SQL Server主要依赖System.Data.SqlClient命名空间下的几个类：SqlConnection负责建立连接，SqlCommand负责执行SQL语句，SqlDataReader负责读取结果集。从.NET Core 3.0开始，微软推荐使用新的Microsoft.Data.SqlClient包，但用法基本一致。
连接数据库的第一步是构造连接字符串。一个典型的连接字符串包含服务器地址、数据库名、认证方式和超时时间几个部分。下面是一段完整的示例代码：
using System;
using Microsoft.Data.SqlClient;
class Program
{
static void Main()
{
// 连接字符串：服务器、数据库、用户名、密码
string connStr = "Server=192.168.0.1;Database=OrderDb;User Id=sa;Password=YourPwd123;Connection Timeout=15;";
// 使用using确保连接用完自动释放
using (SqlConnection conn = new SqlConnection(connStr))
{
try
{
conn.Open(); // 打开连接
Console.WriteLine("连接成功，服务器版本：" + conn.ServerVersion);
string sql = "SELECT COUNT(*) FROM Orders";
using (SqlCommand cmd = new SqlCommand(sql, conn))
{
int count = (int)cmd.ExecuteScalar();
Console.WriteLine("订单总数：" + count);
}
}
catch (SqlException ex)
{
// 数据库异常都会抛出SqlException
Console.WriteLine("连接失败：" + ex.Message);
}
}
}
}
这里有几个关键点需要强调。首先是using语句的使用，它保证了SqlConnection在超出作用域后自动调用Dispose方法，把连接归还给连接池。很多老项目里写的conn.Close()如果没放在finally块里，一旦中间代码抛异常，连接就永远不会关闭，时间一长连接池就被占满了。
其次是认证方式的选择。上面示例用的是SQL Server身份验证（用户名加密码），另一种是Windows集成认证，连接字符串写成Server=.;Database=OrderDb;Integrated Security=True;。集成认证不用在代码里暴露密码，安全性更好，但要求客户端和数据库服务器在同一个域或者有信任关系，Web应用部署时通常不如账号密码方式灵活。
二、连接字符串常用参数详解与推荐配置
连接字符串里可以配置的参数很多，理解每个参数的含义对排查问题非常关键。下面把常用的参数整理成表格：
| 参数 | 说明 | 默认值 |
|---|---|---|
| Server / Data Source | 服务器地址，可以是IP、主机名或实例名，如192.168.0.1\SQLEXPRESS | 无 |
| Database / Initial Catalog | 要连接的数据库名称 | 无 |
| User Id / Password | SQL Server身份验证的账号密码 | 无 |
| Integrated Security | 设为True时使用Windows身份验证 | False |
| Connection Timeout | 建立连接的最长等待秒数，不是查询超时 | 15秒 |
| Max Pool Size | 连接池最大连接数 | 100 |
| Pooling | 是否启用连接池，设为False可排查池相关问题 | True |
| TrustServerCertificate | 加密连接时不校验证书，新驱动默认加密导致报错时常用 | False |
这里有一个非常典型的坑值得单独说：升级到Microsoft.Data.SqlClient 4.0之后，很多人突然连不上数据库了，报错内容是证书链不受信任。原因是新版本默认开启了加密（Encrypt=True），如果服务器用的是自签名证书就会验证失败。解决办法是在连接字符串里加上TrustServerCertificate=True;，或者给服务器配置正规证书。这个坑困扰过大量开发者，遇到类似报错先检查这里。
另外，命名实例的连接方式也要注意。如果SQL Server安装时用的是默认实例，直接写IP就能连；如果是命名实例（比如SQLEXPRESS），需要写成Server=192.168.0.1\SQLEXPRESS;，并且服务器上的SQL Server Browser服务必须启动，否则客户端找不到实例监听的端口，同样会报连接超时。
三、连接超时问题的成因分析与排查步骤
连接超时的报错信息一般是“连接超时时间已到，在尝试使用登录前握手期间经过的时间超过此时间”或者英文的“timeout period elapsed prior to connection attempt”。遇到这类错误，首先要分清两个容易混淆的概念：Connection Timeout和Command Timeout。前者控制建立连接的等待时间，也就是conn.Open()这一步最多等多久；后者控制单条命令执行的时间，通过cmd.CommandTimeout设置。如果你的报错发生在Open阶段，调大CommandTimeout毫无用处，必须排查连接本身的问题。
连接超时的常见原因可以按以下顺序逐项排查：
- 网络不通：先用ping命令确认客户端到服务器网络是否可达，再用
Test-NetConnection 192.168.0.1 -Port 1433（PowerShell命令）测试SQL Server默认端口1433是否通。很多服务器默认开启了防火墙，1433端口没放行是最常见的原因。 - SQL Server未启用TCP/IP协议：打开SQL Server配置管理器，检查SQL Server网络配置中TCP/IP是否已启用，禁用状态下客户端根本无法走网络连接，只支持本机共享内存方式。
- SQL Server Browser服务未启动：连接命名实例时必须有这个服务，否则无法解析实例端口。
- 连接字符串写错：实例名拼写错误、数据库名不存在、密码包含特殊字符没转义等，这些会报不同的错误，仔细核对即可。
- 服务器负载或登录卡住：服务器内存不足、连接数达到上限（可以用存储过程sp_who查看当前连接）也可能表现为超时。
定位问题时，推荐先用最小化的方式验证：写一个只有几行代码的控制台程序，用同样的连接字符串去连，排除业务代码的干扰。如果控制台程序也连不上，那问题一定在环境层面；如果控制台能连而正式程序不行，就要检查程序的配置文件、账号权限和连接池设置了。
四、连接池原理与超时的另一种可能
很多开发者不知道，SqlConnection其实并不是每次都真正新建物理连接。ADO.NET内置了连接池机制：调用Close或Dispose时，物理连接不会被销毁，而是归还到池里；下次再用完全相同的连接字符串打开连接时，直接从池里取现成的连接，省去了TCP握手和登录认证的开销，性能提升非常明显。
但连接池也会带来一类特殊的超时错误：“超时过期，在从池中获取连接之前经过的时间” (The timeout period elapsed prior to obtaining a connection from the pool)。这个错误说明代码请求连接的速度超过了归还的速度，池已经达到Max Pool Size上限。常见原因包括：代码里没有及时释放连接（比如忘了using）、存在慢查询长时间占用连接、或者并发量确实超过了100的上限。对应的解决办法是检查所有SqlConnection是否都用了using包裹，优化慢SQL，必要时调大Max Pool Size，例如：
string connStr = "Server=192.168.0.1;Database=OrderDb;User Id=sa;Password=YourPwd123;" +
"Max Pool Size=200;Min Pool Size=10;Connection Timeout=15;";
// 异步方式打开连接，避免阻塞线程（适合Web高并发场景）
public async Task<int> GetOrderCountAsync(string connStr)
{
using (SqlConnection conn = new SqlConnection(connStr))
{
await conn.OpenAsync();
using (SqlCommand cmd = new SqlCommand("SELECT COUNT(*) FROM Orders", conn))
{
object result = await cmd.ExecuteScalarAsync();
return Convert.ToInt32(result);
}
}
}
还有一个细节需要注意：连接池是按连接字符串精确匹配的，字符串里任何一个字符不同（哪怕多一个空格）都会创建独立的池。如果系统中存在拼出来的连接字符串各不相同的情况，池的数量会失控，这也是一种隐性的资源泄漏。最佳实践是把连接字符串统一放在配置文件的ConnectionStrings节点里，通过ConfigurationManager.ConnectionStrings或.NET Core的IConfiguration读取，全程序只保留一份定义。
总结一下，C#连接SQL Server本身不难，难的是把连接字符串参数、超时类型、连接池行为这几层机制理解透。遇到超时先分清是连接超时、命令超时还是池获取超时，再按网络、端口、SQL Server配置的顺序逐层排查，绝大多数问题都能快速定位。写代码时坚持using释放资源、连接字符串统一管理、异步操作高并发场景，就能避开绝大多数坑。
C#连接SQL Server数据库连接超时SqlConnection修改时间：2026-08-31 11:37:09