c#如何连接SQLServer数据库_c#SQLServer数据库常见问题与排错指南

说个真相，绝大多数连接失败，还真不是网络问题或者权限问题，而是出在连接字符串上。SQL Server 支持好几种身份验证方式，对应的字符串结构差异挺大，但细节一多就容易写错。

Windows 身份验证是本地开发最常用的："Server=localhost\SQLEXPRESS;Database=MyDb;Trusted_Connection=true;"。注意这里双反斜杠是为了转义，SQLEXPRESS 是默认实例名，如果你用的是默认实例，直接写 localhost 或者 . 会更省事。

如果是 SQL Server 账户登录，写法就变成了 "Server=localhost;Database=MyDb;User Id=myuser;Password=mypass;"。这里有个前提：SQL Server 本身得允许“SQL Server 和 Windows 身份验证模式”，而且该账户必须已经添加到目标数据库的 db_datareader 或 db_datawriter 角色里。

还有个容易忽略的点：连接超时默认是 15 秒。如果你的数据库在高延迟环境里，建议显式加上 Connect Timeout=30;，免得无缘无故超时。

最稳妥的办法还是别硬背格式。直接用 Visual Studio 的“服务器资源管理器”，右键“添加连接”，填好信息点测试，成功之后直接把生成的字符串复制出来——这才是真正的“一次搞定”。

明明账号密码都对，却总看到“Login failed for user”

这个错误看着像认证失败，但原因往往藏在深处：

• 确认 SQL Server 服务是否启动了。去 Windows 服务里检查 SQL Server (MSSQLSERVER) 或者 SQL Server (SQLEXPRESS) 的状态，没启动一切免谈。
• 目标数据库是不是真的存在？Database=MyDb 里的 MyDb 必须已经建好。多数情况下大小写不敏感，但一旦碰上区分大小写的排序规则，拼写错误也是致命伤。
• 别忘了用户映射。就算登录成功了，但如果没在目标库里执行过 CREATE USER [myuser] FOR LOGIN [myuser];，数据库依然会拒绝访问。
• 防火墙有没有拦截？SQL Server 默认监听 1433 端口，远程连接时必须确认 Windows 防火墙放行了这个端口，还得在 SQL Server 配置管理器里启用“SQL Server 网络配置 → 协议 → TCP/IP”。

快速验证的方法是：直接用 sqlcmd -S localhost -U myuser -P mypass -d MyDb 在命令行跑一下。这条命令能帮你排除 C# 代码的干扰，到底是环境问题还是代码问题，一测便知。

using 没写好？那就等着“Timeout expired”吧

连接池是个好东西，但如果你不显式关闭或者释放 SqlConnection，连接就会长期被占用，直到池被耗尽。下面这种写法简直是定时冲击波：

SqlConnection conn = new SqlConnection(connStr);
 conn.Open();
// 忘了 Close()，也没用 using
// 执行查询...

正确的做法就是老老实实用 using 语句块。它等价于 try/finally + Dispose()，就算发生了异常，连接也会被自动释放：

using (var conn = new SqlConnection(connStr))
 {
     conn.Open();
     using (var cmd = new SqlCommand("SELECT * FROM Users", conn))
     {
         var reader = cmd.ExecuteReader();
         while (reader.Read()) { /* 处理 */ }
     } // reader.Dispose() 自动触发
 } // conn.Dispose() 自动触发，连接归还池中

有个小提醒：不要手动调用 conn.Close() 再额外调用 conn.Dispose()，重复操作可能会抛 InvalidOperationException。也千万别跨 using 块去复用同一个 conn 对象。

插入 DateTime 时，总被“从字符串转换日期和时间时失败”卡住

这事儿说起来很典型：参数化查询没用好。尤其是当 C# 传 DateTime.Now 到 datetime 或 datetime2 列的时候。

• 错误做法：拼接 SQL 字符串。比如 "INSERT INTO Logs VALUES ('" + DateTime.Now + "')"。这种写法完全依赖你机器上的区域设置，不同环境的格式千奇百怪，不出错才怪。
• 正确做法：一律参数化查询。SqlCommand.Parameters.Add("@time", SqlDbType.DateTime2).Value = DateTime.Now;，干净又安全。
• 类型匹配也得注意：datetime 支持的范围是 1753 年到 9999 年，datetime2 则是 0001 年到 9999 年。C# 的 DateTime.MinValue（0001-01-01）要是塞进 datetime 列，直接报错。
• 空值用 DBNull.Value 处理，别直接传 null。比如 cmd.Parameters.Add("@optDate", SqlDbType.DateTime2).Value = dateVal ?? (object)DBNull.Value;。

哪怕你只是要查一条数据，也别图省事拼 SQL 字符串。SQL 注入风险只是一个层面的问题，类型转换失败才是日常开发里最让你头疼的地方。