Java 連接 MySQL 報錯排查指南：常見原因與解決步驟

最小可運行示例

import java.sql.*;

public class JdbcTest {
    static final String URL = "jdbc:mysql://localhost:3306/testdb?useSSL=false&serverTimezone=Asia/Shanghai";
    static final String USER = "root";
    static final String PASS = "123456";

    public static void main(String[] args) {
        try (Connection conn = DriverManager.getConnection(URL, USER, PASS)) {
            System.out.println("連接成功！");
            try (Statement st = conn.createStatement();
                 ResultSet rs = st.executeQuery("SELECT VERSION()")) {
                if (rs.next()) System.out.println("MySQL 版本: " + rs.getString(1));
            }
        } catch (SQLException e) {
            e.printStackTrace(); // 關鍵：打印完整堆棧，包含 SQLState、ErrorCode
        }
    }
}

調試技巧

• 在 catch 塊打印 e.getSQLState()、e.getErrorCode()，對照 MySQL 錯誤碼文檔。
• 使用數據庫客戶端（Workbench、DBeaver）先驗證賬號/密碼/網絡連通性。
• 啟用驅動日誌：java -Djavax.net.debug=ssl ... 或 URL 加 logger=com.mysql.cj.log.StandardLogger&profileSQL=true。

總結

遇到連接報錯，請貼出完整異常堆棧文本而非截圖，按上述清單逐項排查，90% 問題可在 5 分鐘內定位解決。