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

spring boot 项目配置 mysql 连接需使用 spring-boot-starter-data-jdbc 或 spring-boot-starter-data-jpa，避免手动引入旧驱动；application.yml 中必须配置 spring.datasource.url（含 servertimezone 和 characterencoding）、username、password 及 3.x 必显式指定 driver-class-name 为 com.mysql.cj.jdbc.driver。

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 缓存和时区同步：本地开发用 localhost 没问题，但容器部署时若用 service 名，kubernetes 的 DNS TTL 可能导致 IP 变更后连接持续失败；serverTimezone 不配或配错，会使 datetime 字段读写偏移整小时。