萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 資料庫 >> MS SQL 資料庫

C# 連線 SQL Server 錯誤 40:逸出字元「\」導致實例名稱解析失敗

問題現場:連線字串明明正確,卻拋出 Error 40

開發環境:SQL Server 2008 + Visual Studio 2013 + .NET 4.0。資料庫採用命名實例安裝,連線字串理應寫作:

Server=MyMachine\MyInstance;Database=MyDB;Integrated Security=True;

但在 conn.Open() 時拋出經典錯誤:

找不到 SQL Server 執行個體,或無法建立遠端連線 (provider: SQL Network Interfaces, error: 40)

Error 40 錯誤畫面

根因分析:被忽略的 C# 字串逸出機制

連線字串中的 \ 在 C# 一般字串字面值中是逸出字元。若實例名稱以 t 開頭 (如 MyMachine\tSQL),\t 會被編譯器解譯為定位字元 (Tab),導致實際傳遞給 SqlClient 的字串變成 MyMachine SQL (含 Tab),自然找不到實例。

驗證過程

  • 舊專案連線字串前綴 @ (逐字字串) 運作正常
  • 新專案實例名改為 t... 開頭,忘記加 @,編譯不報錯 (因 \t 是合法逸出序列),執行期卻連線失敗
  • 花費 1+ 小時排查防火牆、SQL Browser、通訊協定、IP 位址等網路層面,實為程式碼層級低級錯誤

解決方案:養成 @ 逐字字串習慣

// ✅ 正確:逐字字串字面值,\ 視為普通字元
string connStr = @"Server=MyMachine\MyInstance;Database=MyDB;Integrated Security=True;";

// ❌ 錯誤:一般字串字面值,\t 會被解譯為 Tab
string connStr = "Server=MyMachine\MyInstance;Database=MyDB;Integrated Security=True;";

延伸提醒:所有 Windows 路徑與連線字串都應加 @

場景錯誤寫法正確寫法
SQL 連線字串 (命名實例)"Server=PC\SQLEXPRESS;"@"Server=PC\SQLEXPRESS;"
檔案路徑"C:\Data\File.txt"@"C:\Data\File.txt"
登錄機碼路徑"HKLM\Software\MyApp"@"HKLM\Software\MyApp"
最佳實務:在 C# 中處理任何包含反斜線的 Windows 路徑、SQL 實例名稱、登錄路徑,**永遠使用 @ 逐字字串字面值**,消除逸出字元干擾,提升程式碼可讀性與正確性。

補充:其他常見 Error 40 成因速查

  • SQL Browser 服務未啟動 (命名實例解析需透過 UDP 1434)
  • 防火牆封鎖 TCP 1433 (預設實例) 或動態埠 (命名實例)
  • SQL Server 組態管理員中 TCP/IP、命名管道通訊協定未啟用
  • 連線字串伺服器名稱拼寫錯誤 (含大小寫、多餘空白)
  • 遠端連線未在 SQL Server 表面積設定中啟用

但若連線字串在程式碼中以一般字串寫法包含 \t、\n、\r 等逸出序列,**網路層面設定再完美也無法連線**,請優先檢查字串字面值寫法。

copyright © 萬盛學電腦網 all rights reserved