Java连MySQL需配置驱动、时区、字符集、连接池四要素;MySQL 8.0+必须用mysql-connector-j 8.x驱动,URL须含serverTimezone和characterEncoding=utf8mb4,Spring Boot需显式配置Hikari参数并确保资源正确关闭。

Java 连 MySQL 不是配个 URL 就完事,驱动、时区、字符集、连接池这四块漏一个就可能连不上或存乱码。
MySQL Connector/J 驱动版本和依赖怎么选
8.0+ 版本的 MySQL 必须用 mysql-connector-j 8.x(不是旧的 mysql-connector-java),Maven 里写成:
mysql mysql-connector-j 8.3.0
常见错误:用 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 或生僻字直接变 ???。
立即学习“Java免费学习笔记(深入)”;
LANUX V1.0 蓝脑商务网站系统 适用于网店、公司宣传自己的品牌和产品。 系统在代码、页面方面设计简约,浏览和后台管理操作效率高。 此版本带可见即可得的html编辑器, 方便直观添加和编辑要发布的内容。 安装: 1.解压后,更换logo、分类名称、幻灯片的图片及名称和链接、联系我们等等页面。 2.将dbconfig.php里面的数据库配置更改为你的mysql数据库配置 3.将整个文件夹上传至
-
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 很难复现,只能靠连接池监控和日志埋点盯住。









