Java中JDBC连接MySQL需四步:加匹配版本驱动、配含关键参数的URL、用try-with-resources建查关连接、验证查询是否成功。

Java 中通过 JDBC 连接 MySQL 数据库,核心是四步:加驱动、配 URL、建连接、关资源。关键不在“能不能连上”,而在“连得稳、查得准、不漏关”。
确保 MySQL 驱动已正确引入
必须把 mysql-connector-java 的 JAR 包加入项目依赖(如 Maven 依赖或手动添加到 lib 目录)。版本要匹配你的 MySQL:
- MySQL 5.7 → 推荐用
mysql-connector-java:5.1.49 - MySQL 8.0+ → 必须用
mysql-connector-java:8.0.x或更高(如8.3.0) - 注意:
com.mysql.jdbc.Driver已废弃;新版统一用com.mysql.cj.jdbc.Driver
写对 JDBC 连接 URL
URL 不只是地址,参数错一个就可能静默失败。标准格式:
jdbc:mysql://主机:端口/数据库名?参数1=值1&参数2=值2常用且推荐的完整示例:
jdbc:mysql://localhost:3306/mydb?useSSL=false&serverTimezone=UTC&characterEncoding=utf8&allowPublicKeyRetrieval=true-
useSSL=false:开发环境禁用 SSL(生产环境建议配证书) -
serverTimezone=UTC:避免时区报错(尤其 Windows 系统) -
characterEncoding=utf8:防止中文乱码 -
allowPublicKeyRetrieval=true:MySQL 8.0+ 密码认证方式变更后必需
用 try-with-resources 安全获取连接与执行查询
别手动 close,用自动资源管理防泄漏。下面是最简但生产可用的写法:
String url = "jdbc:mysql://localhost:3306/mydb?useSSL=false&serverTimezone=UTC";
String user = "root";
String pwd = "123456";
try (Connection conn = DriverManager.getConnection(url, user, pwd);
Statement stmt = conn.createStatement();
ResultSet rs = stmt.executeQuery("SELECT id, name FROM users")) {
while (rs.next()) {
System.out.println(rs.getInt("id") + "\t" + rs.getString("name"));
}
} catch (SQLException e) {
System.err.println("数据库操作失败:" + e.getMessage());
}
- Connection、Statement、ResultSet 全部声明在 try() 内,JVM 自动关闭
- 不用显式调用
Class.forName()—— JDBC 4.0+ 驱动支持自动注册 - 查询列优先用
rs.getString("name")而非rs.getString(2),增强可维护性
验证连接是否真的成功
光打印“连接成功”没用,真正验证要走通一次查询。常见失败原因:
- MySQL 服务未启动(检查
netstat -an | findstr :3306或服务管理器) - 用户名/密码错误(默认 root 用户需确认是否改过密码)
- 数据库名拼错,或该库根本不存在
- 防火墙/安全组拦截了 3306 端口(远程连接时重点排查)
- 用户无远程访问权限(本地连 localhost 可能通,IP 连不通时检查
host权限)
Java免费学习笔记:立即使用
解锁 Java 大师之旅:从入门到精通的终极指南











