Java 桌面程序遠程連接 MySQL 失敗的排查步驟

現象描述

本機運行程序可正常連接 MySQL，但部署到未安裝 MySQL 的其他機器上連接失敗。已確認 IP 通訊正常，本機使用內網 IP 或 localhost 均可連接。嘗試開放防火牆 3306 端口、配置 MySQL 用戶遠程權限（%'host'）後問題依舊。

排查清單

1. 網絡連通性：在客戶端執行 telnet <server_ip> 3306。若無法連接，屬網絡/防火牆問題；若能連接，則為權限或配置問題。
2. MySQL 配置：檢查 my.cnf/my.ini 中 bind-address 是否為 0.0.0.0 或具體內網 IP，不可為 127.0.0.1。
3. 用戶權限：確認用戶擁有遠程訪問權限：
   GRANT ALL PRIVILEGES ON *.* TO 'user'@'%' IDENTIFIED BY 'password' WITH GRANT OPTION;
FLUSH PRIVILEGES;
4. 防火牆/安全組：服務器端需放行 3306 入站規則；雲服務器需配置安全組規則。
5. JDBC 連接串：使用 jdbc:mysql://<server_ip>:3306/dbname?useSSL=false&allowPublicKeyRetrieval=true，避免 SSL 協商失敗。

按上述順序逐項驗證，多數情況下為 bind-address 或防火牆設置導致。