// MySQL 錯誤參考

MySQL 錯誤 2026:SSL 連線錯誤

用戶端與 MySQL 伺服器之間的 TLS 交握失敗:用戶端不信任的憑證、TLS 版本不符,或需要 SSL 但已停用。

錯誤號碼
2026
名稱
CR_SSL_CONNECTION_ERROR
類別
連線與用戶端
錯誤訊息
SSL connection error: %s

它的意義

客戶端與伺服器無法建立加密連線。後面的文字 SSL connection error: 是 TLS 函式庫給出的原因,例如憑證驗證失敗或沒有共同支援的協定版本,也是最值得看的部分。

常見原因

  • 客戶端驗證伺服器憑證(--ssl-mode=VERIFY_CA 或 VERIFY_IDENTITY),而該憑證為自簽憑證或主機名稱不符合。
  • 客戶端設定為需要 TLS,而伺服器已停用此功能。
  • 舊版用戶端或伺服器只支援對方已停用的 TLS 版本。
  • CA、憑證或金鑰檔案的路徑或權限錯誤。

如何修正

  1. 檢查伺服器提供的內容。

    SHOW VARIABLES LIKE '%ssl%';
    SHOW VARIABLES LIKE 'tls_version';
  2. 把簽發伺服器憑證的 CA 憑證交給用戶端,例如 mysql --ssl-mode=VERIFY_CA --ssl-ca=ca.pem -h db.example.com -u app -p.

  3. 如果兩端都是舊版,請升級客戶端程式庫,而不是在伺服器上重新啟用舊版 TLS。

相關錯誤

更多連線與用戶端錯誤

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

// 錯誤更少,修復更快

在 SQLly 裡操作 MySQL

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