Java连接MySQL数据库教程

Java连接MySQL远不止配置一个JDBC URL那么简单，驱动版本不匹配、时区未指定、字符集缺失或连接池管理不当，都可能导致连接失败、乱码、emoji存储异常、连接泄漏甚至服务雪崩；尤其MySQL 8.0+必须使用mysql-connector-j 8.x驱动并严格设置serverTimezone和utf8mb4编码，Spring Boot项目还需显式配置HikariCP参数与资源释放机制——本文直击四大核心陷阱，从依赖选型、URL参数取舍、连接池调优到资源生命周期管控，给出生产级可落地的避坑指南。

Java 连 MySQL 不是配个 URL 就完事，驱动、时区、字符集、连接池这四块漏一个就可能连不上或存乱码。

MySQL Connector/J 驱动版本和依赖怎么选

8.0+ 版本的 MySQL 必须用 mysql-connector-j 8.x（不是旧的 mysql-connector-java），Maven 里写成：

<dependency>
  <groupId>mysql</groupId>
  <artifactId>mysql-connector-j</artifactId>
  <version>8.3.0</version>
</dependency>

常见错误：用 5.1.x 驱动连 MySQL 8.0+，抛 Communications link failure 或 Public Key Retrieval is not allowed。后者加 ?allowPublicKeyRetrieval=true&useSSL=false 是临时绕过，根本解法是换驱动。

• MySQL 5.7 → 可用 mysql-connector-j:5.1.49（注意 artifactId 已改）
• MySQL 8.0+ → 必须用 mysql-connector-j:8.0.33+
• JDK 17+ 项目别用 8.0.32 之前版本，有模块系统兼容问题

URL 字符串里哪些参数不能省

最简能通的 URL 是：jdbc:mysql://localhost:3306/mydb?serverTimezone=UTC&characterEncoding=utf8mb4。缺了 serverTimezone 在 Windows 或某些 JDK 下会报 The server time zone value '…' is unrecognized；缺 characterEncoding=utf8mb4 存 emoji 或生僻字直接变 ???。

• useSSL=false：本地开发可关，生产环境必须配真实证书并设为 true
• allowPublicKeyRetrieval=true：仅调试用，开启等于放弃密码加密传输，上线前删掉
• rewriteBatchedStatements=true：批量插入时提升性能，但某些 JDBC 操作（如含 ON DUPLICATE KEY UPDATE）会失效

为什么 DriverManager.getConnection() 能连上，Spring Boot 却报错

因为 Spring Boot 默认用 HikariCP，它校验更严：URL 必须含 serverTimezone，且会主动测试连接（connection-test-query 已弃用，改用 validation-timeout 和 connection-init-sql）。常见现象是启动日志里卡在 HikariPool-1 - Starting… 然后超时。

• application.yml 中必须显式写全：

spring:
  datasource:
    url: jdbc:mysql://localhost:3306/test?serverTimezone=Asia/Shanghai&characterEncoding=utf8mb4
    username: root
    password: 123456
    driver-class-name: com.mysql.cj.jdbc.Driver

• 如果数据库用户名含特殊字符（比如 @），密码要 URL 编码，否则解析 URL 时截断
• Hikari 默认 maximum-pool-size=10，高并发下不够用，得按压测结果调

Connection 对象用完不 close 会怎样

不是内存泄漏那么简单——MySQL 服务端有 wait_timeout（默认 28800 秒），但连接池里的空闲连接被 Hikari 主动回收前，如果应用层没归还（即没调 connection.close()），这个连接就一直占着，直到超时断开，期间无法复用、无法检测有效性，最终池子耗尽，新请求全卡在 getConnection() timeout。

• 务必用 try-with-resources，不要手写 finally { conn.close(); }
• MyBatis / JPA 一般自动管理，但手写 JDBC 时每条 Connection、Statement、ResultSet 都得包进资源声明
• Hikari 的 leak-detection-threshold 设成 60000（毫秒），能帮你抓到没关闭的地方

真正麻烦的是事务边界和连接生命周期耦合——比如一个 service 方法开了事务，中间调了另一个没走事务管理器的方法，它自己 new Connection 并忘了 close，这种 bug 很难复现，只能靠连接池监控和日志埋点盯住。

今天关于《Java连接MySQL数据库教程》的内容介绍就到此结束，如果有什么疑问或者建议，可以在golang学习网公众号下多多回复交流；文中若有不正之处，也希望回复留言以告知！