Visual Studio连接MSSQL报SQL Network Interfaces error:26错误求助

问题描述 #

开发咖啡馆管理系统过程中，多个绑定按钮、文本框的数据库操作触发异常，异常触发位置为数据执行方法内的数据库连接打开语句，报错类型为provider: SQL Network Interfaces, error: 26。

现有代码 #

数据库连接方法 #

SqlConnection con = new SqlConnection();
con.ConnectionString = "data source =DESKTOP-TN9HLSG\SQLEXPRESS;database = kafe; integrated security =True";
return con;

数据执行方法 #

public void setData(String query)
{
    SqlConnection con = getConnection();
    SqlCommand cmd = new SqlCommand();
    cmd.Connection = con;
    con.Open(); // 报错触发位置
    cmd.CommandText = query;
    cmd.ExecuteNonQuery();
    con.Close();
}

错误堆栈 #

[External Code]
KafeUygulamasi.function.setData(string) / function.cs    
KafeUygulamasi.TumKullaniciIslemleri.KD_UrunEkle.btnUrunEkle1_Click(object, System.EventArgs) / KD_UrunEkle.cs
[External Code]
KafeUygulamasi.Program.Main() / Program.cs

解决方案 #

error:26是SQL Server客户端无法定位到目标实例导致的，按以下优先级排查修复：

• 修复连接字符串语法错误：C#普通字符串中\为转义字符，原连接字符串里实例名前的反斜杠未做处理，会导致实例名解析失败。两种修复方式二选一：
  1. 对反斜杠转义：将data source =DESKTOP-TN9HLSG\SQLEXPRESS改为data source =DESKTOP-TN9HLSG\\SQLEXPRESS
  2. 使用逐字字符串：在连接字符串前加@，即con.ConnectionString = @"data source =DESKTOP-TN9HLSG\SQLEXPRESS;database = kafe; integrated security =True";
• 检查SQLEXPRESS实例运行状态：按下Win+R输入services.msc打开服务面板，找到名为SQL Server (SQLEXPRESS)的服务，确认服务状态为「正在运行」，若未启动手动启动即可。
• 确认实例协议配置：打开SQL Server配置管理器，找到「SQL Server网络配置」-「SQLEXPRESS的协议」，启用TCP/IP协议，重启SQLEXPRESS服务后生效。
• 校验数据库存在性：打开SSMS连接本地SQLEXPRESS实例，确认名为kafe的数据库已正常创建，名称无拼写错误。
• 补全资源释放逻辑：现有代码若SQL执行阶段抛出异常，已打开的数据库连接不会被主动关闭，长期运行会出现连接泄漏。建议使用using块自动释放资源，修正后代码如下：

public void setData(String query)
{
    using (SqlConnection con = getConnection())
    {
        using(SqlCommand cmd = new SqlCommand(query, con))
        {
            con.Open();
            cmd.ExecuteNonQuery();
        }
    }
}

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