// MySQL 錯誤參考

MySQL 錯誤 2003:無法連線到主機上的 MySQL 伺服器

客戶端無法對主機和連接埠開啟 TCP 連線。可能是伺服器停機、在其他位置監聽,或防火牆擋在中間。

錯誤號碼
2003
名稱
CR_CONN_HOST_ERROR
類別
連線與用戶端
錯誤訊息
Can't connect to MySQL server on '%s:%u' (%d)

它的意義

2003 是用戶端在 TCP 連線本身失敗時擲出的錯誤。括號中的數字是作業系統錯誤: (111) 或 (10061) 在 Windows 上表示連線被拒絕(沒有程式在監聽), (110) 或 (10060) 表示逾時(通常是防火牆丟棄封包),而 (113) 表示沒有通往主機的路由。

伺服器從未看到登入,因此密碼和權限尚未重要。

常見原因

  • 伺服器未執行,或監聽的連接埠不是 3306。
  • 伺服器僅監聽 127.0.0.1 (bind_address),因此遠端連線會被拒絕。
  • 防火牆、安全群組或雲端網路規則阻擋了連接埠 3306。
  • 連線設定中的主機名稱或 IP 位址錯誤。

如何修正

  1. 在伺服器上,確認 MySQL 有在執行,以及它監聽的位址與連接埠。

    SHOW VARIABLES WHERE Variable_name IN ('bind_address', 'port', 'skip_networking');
  2. 要接受遠端連線,請設定 bind_address = 0.0.0.0 (或伺服器自身的 IP)中設定 [mysqld] 區段,然後重新啟動 MySQL。請確定遠端主機已有帳戶。

  3. 在伺服器的防火牆和任何雲端安全性群組中開啟該連接埠,然後從用戶端機器測試,例如使用 nc -vz db.example.com 3306.

相關錯誤

更多連線與用戶端錯誤

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

// 錯誤更少,修復更快

在 SQLly 裡操作 MySQL

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