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 格式错、权限没开、驱动不匹配。下面列几个高频错误现象和操作点：
Difeye是一款超轻量级PHP框架，主要特点有： Difeye是一款超轻量级PHP框架，主要特点有： ◆数据库连接做自动主从读写分离配置，适合单机和分布式站点部署； ◆支持Smarty模板机制，可灵活配置第三方缓存组件； ◆完全分离页面和动作，仿C#页面加载自动执行Page_Load入口函数； ◆支持mysql，mongodb等第三方数据库模块，支持读写分离，分布式部署； ◆增加后台管理开发示例
- 报错
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 字段读写偏移整小时。
