錯誤現象
System.Data.SqlClient.SqlException:
在與 SQL Server 建立連接時出現與網絡相關的或特定於實例的錯誤。
未找到或無法訪問服務器。
請驗證實例名稱是否正確並且 SQL Server 已配置為允許遠程連接。
(provider: 命名管道提供程序, error: 40 - 無法打開到 SQL Server 的連接)
根因分析矩陣
| 原因類別 | 具體原因 | 驗證方法 |
| 實例名稱 | Express 版本需加實例名 | 配置管理器查看實例名 |
| 默認實例 vs 命名實例 | 默認用 . 或 localhost,命名用 .\SQLEXPRESS |
| 連接字符串轉義 | C# 字符串中 \ 需雙寫或 @ 字符串 |
| 網絡協議 | TCP/IP 未啟用 | 配置管理器 → 網絡配置 → TCP/IP 啟用 |
| Named Pipes 未啟用 | 同位置啟用 Named Pipes |
| 防火牆阻擋 1433/動態端口 | telnet ip 1433、防火牆入站規則 |
| 認證模式 | 僅 Windows 認證 | 屬性 → 安全性 → SQL Server 和 Windows 身份驗證 |
| sa 賬號禁用/密碼錯誤 | 安全性 → 登錄名 → sa → 啟用、重置密碼 |
| 服務狀態 | SQL Server 服務未運行 | services.msc / 配置管理器啟動 |
| 瀏覽器服務 | SQL Server Browser 未啟動(命名實例需) | 啟動 SQL Server Browser 服務 |
標準排查步驟
1. 確認服務運行
services.msc → SQL Server (MSSQLSERVER / SQLEXPRESS) → 運行中
2. 啟用遠程連接協議
SQL Server 配置管理器
→ SQL Server 網絡配置
→ Protocols for MSSQLSERVER/SQLEXPRESS
→ TCP/IP: 啟用, IPAll: TCP Port 1433
→ Named Pipes: 啟用
→ 重啟服務
3. 設置混合認證模式
SSMS → 服務器右鍵 → 屬性 → 安全性
→ 服務器身份驗證: "SQL Server 和 Windows 身份驗證模式"
→ 確定 → 重啟服務
4. 啟用 sa 賬號並設置密碼
SSMS → 安全性 → 登錄名 → sa 右鍵 → 屬性
→ 常規: 設置密碼、取消"強制密碼策略"
→ 狀態: 登錄 → "啟用"
5. 正確的連接字符串
| 場景 | 連接字符串 |
| 默認實例,本機 | Server=.;Database=Northwind;User ID=sa;Password=xxx; |
| Express 命名實例,本機 | Server=.\SQLEXPRESS;Database=Northwind;User ID=sa;Password=xxx; |
| 遠程默認實例 | Server=192.168.1.100;Database=Northwind;User ID=sa;Password=xxx; |
| 遠程命名實例 | Server=192.168.1.100\SQLEXPRESS;Database=Northwind;User ID=sa;Password=xxx; |
| C# 代碼中(@ 字符串) | @"Server=.\SQLEXPRESS;Database=Northwind;User ID=sa;Password=xxx;" |
6. 防火牆放行
# 入站規則:TCP 1433 (默認實例)
# 動態端口:SQL Browser 服務 UDP 1434 + TCP 動態端口
# 建議:固定 TCP 端口,僅放行該端口
7. 註冊 ASP.NET SQL Server(如用 Membership)
C:\Windows\Microsoft.NET\Framework\v2.0.50727\aspnet_regsql.exe
# 向導選擇目標服務器、數據庫、認證方式
診斷工具
telnet server_ip 1433:測試端口連通性
cliconfg:客戶端網絡實用程序,添加別名測試
- SQL Server Configuration Manager → SQL Server 服務 → 啟動參數檢查
- 錯誤日誌:
C:\Program Files\Microsoft SQL Server\MSSQL.x\MSSQL\Log\ERRORLOG