SqlConnection连接失败需先检查实例状态、连接字符串准确性、TCP/IP协议启用、认证模式及用户权限，而非直接修改代码。
能连上，但大概率第一次会卡在连接字符串或身份验证方式上。不是代码写错，而是环境配置没对齐。
SqlConnection 连接失败的常见报错和对应检查点
看到 SqlException: A network-related or instance-specific error occurred 或 Login failed for user，别急着改代码，先确认这几点：
- SQL Server 实例是否正在运行？检查 Windows 服务里
SQL Server (MSSQLSERVER)或SQL Server (SQLEXPRESS)是否是“正在运行”状态 - 连接字符串里的
Data Source值是否准确？(local)、.、(localdb)MSSQLLocalDB、localhost表示不同实例，不能混用 - SQL Server 是否启用了 TCP/IP 协议？用 SQL Server Configuration Manager 检查“SQL Server 网络配置 → 协议 → TCP/IP”是否为“已启用”
- 如果是 SQL 账户登录，确认 SQL Server 已设为“混合模式认证”，且该用户已在
Security → Logins中存在并映射到目标数据库
连接字符串怎么写才不踩坑
硬编码连接字符串是调试期最方便的方式，但必须注意格式细节和安全边界：
- Windows 身份验证（推荐本地开发）：
"Data Source=.;Initial Catalog=TestDB;Integrated Security=true;"—— 注意Integrated Security=true不能写成yes或sspi（虽然后者在旧版中可用，但新项目统一用true） - SQL 账户登录：
"Data Source=localhost\SQLEXPRESS;Initial Catalog=TestDB;User Id=sa;Password=123456;"—— 实例名带反斜杠时，C# 字符串里要写成双反斜杠\，或用 @ 字符串：@'Data Source=localhostSQLEXPRESS;...' - LocalDB 场景（VS 自带）：
"Data Source=(localdb)\MSSQLLocalDB;Initial Catalog=TestDB;Integrated Security=true;"—— 注意括号和反斜杠顺序，少一个字符就报“找不到服务器” - 绝对不要把密码明文塞进代码；上线前务必移入
appsettings.json并启用 Secret Manager 或 Azure Key Vault
为什么用 using 包裹 SqlConnection 和 SqlCommand
这不是风格问题，是资源泄漏的高发区。SqlConnection 内部持有一个底层网络连接，而 .NET 的连接池机制依赖于显式释放：
- 不加
using且没调Close()：连接不会立刻关闭，而是滞留在池中直到超时（默认 300 秒），并发高时很快耗尽连接数，报错Timeout expired -
using保证即使发生异常，Dispose()也会被调用，从而归还连接到池中 - SqlCommand 同理：它持有参数、执行计划缓存等资源，不释放可能引发内存缓慢增长
- 正确写法示例：
using (var conn = new SqlConnection(connStr)) { conn.Open(); using (var cmd = new SqlCommand("SELECT COUNT(*) FROM Users", conn)) { var count = (int)cmd.ExecuteScalar(); } }
参数化查询不是可选项，是必选项
哪怕你 100% 确信输入来自内部表单，也必须用 @param 占位符。SQL 注入不是“会不会发生”，而是“什么时候发生”：
- 错误示范：
"INSERT INTO Users VALUES ('" + name + "', '" + email + "')"—— 一旦name是O'Reilly，语句直接语法错误；更糟的是Robert'); DROP TABLE Users; -- - 正确写法：
"INSERT INTO Users (Name, Email) VALUES (@name, @email)"，再通过cmd.Parameters.Add("@name", name)绑定 - 注意类型匹配：传
DateTime就用SqlDbType.DateTime，传string长度超 4000 字符时建议显式指定SqlDbType.NVarChar和Size，避免隐式截断 - Dapper 或 EF Core 会自动参数化，但原生 ADO.NET 必须手动做
真正难的从来不是“怎么写”，而是“怎么让连接串、实例状态、协议配置、防火墙端口、账户权限全部同时对齐”。每次连不上，优先打开 SQL Server Configuration Manager 和 SSMS 登录试试，比翻代码快得多。
