// MySQL 錯誤參考

MySQL 錯誤 2005:未知的 MySQL 伺服器主機

客戶端無法將主機名稱解析為位址。請檢查拼字、DNS,以及該名稱是否只能在 VPN 或 Docker 網路內解析。

錯誤號碼
2005
名稱
CR_UNKNOWN_HOST
類別
連線與用戶端
錯誤訊息
Unknown MySQL server host '%s' (%d)

它的意義

連線之前,客戶端會先解析主機名稱。2005 表示解析失敗,因此根本沒有嘗試連線。方括號裡的數字是解析器的錯誤碼。

常見原因

  • 主機名稱打錯字,或把 scheme 或連接埠貼進了主機欄位(mysql://db:3306).
  • 這個名稱只會在私人網路或 VPN 上解析,而你目前並未連上。
  • 在 Compose 網路之外使用 Docker Compose 的服務名稱——那裡解析不到這個名稱。
  • 用戶端電腦上的 DNS 問題。

如何修正

  1. 檢查名稱能否從用戶端機器解析,例如使用 nslookup db.example.com 或 ping db.example.com.

  2. 主機欄位只填主機名稱,連接埠欄位只填連接埠。

  3. 從主機機器上,要連到容器的連接埠得透過 127.0.0.1 以及發布在外的連接埠,而不是服務名稱。

相關錯誤

更多連線與用戶端錯誤

程式碼和訊息文字來自 MySQL 8.4 錯誤訊息參考。瀏覽完整的 MySQL 錯誤清單 或 搜尋每個資料庫錯誤.

// 錯誤更少,修復更快

在 SQLly 裡操作 MySQL

適用於 macOS、Windows 和 Linux 的原生 SQL 客戶端,具備結構描述感知的 IntelliSense、高風險陳述式防護與清楚的錯誤訊息,適用於 MySQL 和你使用的其他資料庫。