mysql Spring Boot连接配置_mysql数据库类库整合

来源：这里教程网时间：2026-02-28 20:52:42 作者：

Spring Boot 项目里怎么配 MySQL 连接？

直接用

spring-boot-starter-data-jdbc

或

spring-boot-starter-data-jpa

就行，别手动引

mysql-connector-java

—— Spring Boot 2.4+ 已默认用

mysql-java-connector

（即新版

mysql-connector-j

），旧版驱动在高版本 JDK（如 JDK 17+）上会报

java.lang.ClassNotFoundException: com.mysql.jdbc.Driver

。

关键配置写在

application.yml

或

application.properties

里，必须包含：

spring.datasource.url
：带
serverTimezone
和
characterEncoding
，例如
jdbc:mysql://localhost:3306/mydb?serverTimezone=Asia/Shanghai&characterEncoding=utf8mb4

spring.datasource.username
和
spring.datasource.password

spring.datasource.driver-class-name
：Spring Boot 3.x 必须显式写
com.mysql.cj.jdbc.Driver
；2.x 可省略，但建议保留以防自动推导失败

为什么连不上？常见报错和对应解法

连不上基本就三类原因：URL 格式错、权限没开、驱动不匹配。下面列几个高频错误现象和操作点：

报错
Access denied for user 'xxx'@'localhost'
：不是密码错，而是 MySQL 8 默认用
caching_sha2_password
插件，而旧驱动不支持。解决方法：登录 MySQL 执行
ALTER USER 'xxx'@'localhost' IDENTIFIED WITH mysql_native_password BY 'your_password';
报错
Public Key Retrieval is not allowed
：URL 缺
&allowPublicKeyRetrieval=true
，补上即可（仅测试环境用，生产应配 SSL）启动时报
Failed to configure a DataSource
：检查是否漏了
spring-boot-starter-jdbc
依赖，或
spring.datasource.*
配置项拼写错误（比如写成
datasoruce
）

MySQL 驱动版本和 Spring Boot 版本怎么对得上？

版本不匹配会导致连接成功但执行 SQL 报奇怪异常（比如

ResultSet is closed

或时间字段解析错）。记住这几点：

Spring Boot 2.4.x – 2.7.x → 推荐
mysql:mysql-connector-java:8.0.33
Spring Boot 3.0.x – 3.2.x → 必须用
mysql:mysql-connector-j:8.2.0
（注意 artifactId 已从
mysql-connector-java
改为
mysql-connector-j
） Maven 里别同时引新旧两个 connector，会冲突；删掉
exclusion
也不顶用，得彻底清理依赖树

连接池要不要配？HikariCP 怎么调参？

Spring Boot 2.0+ 默认用 HikariCP，不用额外引包。但默认配置偏保守，线上需调整：

spring.datasource.hikari.maximum-pool-size
：默认 10，一般设为 CPU 核数 × (2–4)，比如 8 核服务器可设 24
spring.datasource.hikari.connection-timeout
：默认 30000（30 秒），业务接口超时若短于这个值，建议同步下调，避免线程卡死
spring.datasource.hikari.validation-timeout
和
connection-test-query
不要设 —— Hikari 用
isValid()
检活，设了反而降低性能如果 MySQL 开了
wait_timeout
（默认 8 小时），记得配
spring.datasource.hikari.idle-timeout
（如 1800000 = 30 分钟）并小于它，否则连接被服务端断开后 Hikari 不知道

真正容易被忽略的是 DNS 缓存和时区同步：本地开发用