MySQL JDBC驱动应选mysql-connector-j 8.0.33+（JDK 17+需8.3.0+），适配MySQL 8.0+的caching_sha2_password认证，Maven声明scope为runtime，URL须含useSSL=false、serverTimezone=UTC和allowPublicKeyRetrieval=true。
MySQL JDBC驱动怎么选版本？
Java连接MySQL必须用官方提供的JDBC驱动，也就是mysql-connector-j。不是所有版本都兼容你的JDK和MySQL服务端——JDK 17+ 要用 mysql-connector-j 8.0.33+；MySQL 8.0+ 默认开启caching_sha2_password插件，老驱动（比如5.1.x）连不上，会报Public Key Retrieval is not allowed或Unknown initial character set index。
- 优先下载最新稳定版：去MySQL官网下
mysql-connector-j-8.3.0.jar（或对应版本），别用Maven中央仓库里标着“legacy”的5.1分支
- 如果项目还在用JDK 8，
mysql-connector-j 8.0.33 仍支持，但得加启动参数：-Dfile.encoding=UTF-8，否则中文表名/字段可能乱码
- 别把jar丢进
jdk/jre/lib/ext这种地方，现代项目统一走classpath管理，IDE里加依赖、Maven写dependency就行
Maven依赖怎么写才不踩坑？
直接贴能跑的配置，不是示例模板。注意scope别写成test，也别漏掉runtime——驱动类在运行时才加载，编译期不需要。
- Maven中声明如下（以8.3.0为例）：
<dependency>
<groupId>mysql</groupId>
<artifactId>mysql-connector-j</artifactId>
<version>8.3.0</version>
<scope>runtime</scope>
</dependency>
- 如果用Spring Boot 3.x，它默认带
mysql-connector-j 8.0.33，你显式声明反而容易引发版本冲突，除非真要升到8.3.x，否则删掉自定义依赖更安全
- Gradle用户注意：
runtimeOnly 是等效写法，别用implementation，否则打包后Tomcat可能报java.lang.ClassNotFoundException: com.mysql.cj.jdbc.Driver
URL字符串里哪些参数不能省？jdbc:mysql://开头的URL看着简单，但少一个关键参数，应用启动就卡住或连上就出错。特别是MySQL 8.0+，默认不认旧协议。
- 最小可用URL（本地默认端口、无SSL）：
jdbc:mysql://localhost:3306/testdb?useSSL=false&serverTimezone=UTC&allowPublicKeyRetrieval=true
-
useSSL=false：开发环境不配证书时必须关，否则连不上，报SSLHandshakeException
-
serverTimezone=UTC：MySQL 8.0+ 默认时区是SYSTEM，Java客户端如果没对齐，Timestamp字段会偏8小时；设成Asia/Shanghai也行，但得确保JVM里有对应时区数据
-
allowPublicKeyRetrieval=true：解决caching_sha2_password认证失败，生产环境应配好MySQL用户密码插件，而不是靠这个参数绕过
Driver注册和Connection获取还有人手动Class.forName？
JDBC 4.0+（JDK 6起）已支持SPI自动加载，Class.forName("com.mysql.cj.jdbc.Driver")这行代码纯属冗余，留着不仅没用，还可能在模块化（JPMS）环境下触发NoClassDefFoundError。
- 正确做法：直接
DriverManager.getConnection(url, user, pass)，驱动类由JDBC服务发现机制自动注册
- 如果用HikariCP、Druid这类连接池，它们内部已处理驱动加载，你只需配URL和账号，不用碰
Driver类
- 唯一需要显式加载驱动的场景：某些老旧OSGi容器或自定义ClassLoader环境，普通Spring Boot/Web项目完全不用管
mysql-connector-j-8.3.0.jar（或对应版本），别用Maven中央仓库里标着“legacy”的5.1分支mysql-connector-j 8.0.33 仍支持，但得加启动参数：-Dfile.encoding=UTF-8，否则中文表名/字段可能乱码jdk/jre/lib/ext这种地方，现代项目统一走classpath管理，IDE里加依赖、Maven写dependency就行scope别写成test，也别漏掉runtime——驱动类在运行时才加载，编译期不需要。
- Maven中声明如下（以8.3.0为例）：
<dependency> <groupId>mysql</groupId> <artifactId>mysql-connector-j</artifactId> <version>8.3.0</version> <scope>runtime</scope> </dependency>
- 如果用Spring Boot 3.x，它默认带
mysql-connector-j8.0.33，你显式声明反而容易引发版本冲突，除非真要升到8.3.x，否则删掉自定义依赖更安全 - Gradle用户注意：
runtimeOnly是等效写法，别用implementation，否则打包后Tomcat可能报java.lang.ClassNotFoundException: com.mysql.cj.jdbc.Driver
URL字符串里哪些参数不能省？jdbc:mysql://开头的URL看着简单，但少一个关键参数，应用启动就卡住或连上就出错。特别是MySQL 8.0+，默认不认旧协议。
- 最小可用URL（本地默认端口、无SSL）：
jdbc:mysql://localhost:3306/testdb?useSSL=false&serverTimezone=UTC&allowPublicKeyRetrieval=true
-
useSSL=false：开发环境不配证书时必须关，否则连不上，报SSLHandshakeException
-
serverTimezone=UTC：MySQL 8.0+ 默认时区是SYSTEM，Java客户端如果没对齐，Timestamp字段会偏8小时；设成Asia/Shanghai也行，但得确保JVM里有对应时区数据
-
allowPublicKeyRetrieval=true：解决caching_sha2_password认证失败，生产环境应配好MySQL用户密码插件，而不是靠这个参数绕过
Driver注册和Connection获取还有人手动Class.forName？
JDBC 4.0+（JDK 6起）已支持SPI自动加载，Class.forName("com.mysql.cj.jdbc.Driver")这行代码纯属冗余，留着不仅没用，还可能在模块化（JPMS）环境下触发NoClassDefFoundError。
- 正确做法：直接
DriverManager.getConnection(url, user, pass)，驱动类由JDBC服务发现机制自动注册
- 如果用HikariCP、Druid这类连接池，它们内部已处理驱动加载，你只需配URL和账号，不用碰
Driver类
- 唯一需要显式加载驱动的场景：某些老旧OSGi容器或自定义ClassLoader环境，普通Spring Boot/Web项目完全不用管
jdbc:mysql://localhost:3306/testdb?useSSL=false&serverTimezone=UTC&allowPublicKeyRetrieval=true
useSSL=false：开发环境不配证书时必须关，否则连不上，报SSLHandshakeException
serverTimezone=UTC：MySQL 8.0+ 默认时区是SYSTEM，Java客户端如果没对齐，Timestamp字段会偏8小时；设成Asia/Shanghai也行，但得确保JVM里有对应时区数据allowPublicKeyRetrieval=true：解决caching_sha2_password认证失败，生产环境应配好MySQL用户密码插件，而不是靠这个参数绕过Class.forName("com.mysql.cj.jdbc.Driver")这行代码纯属冗余，留着不仅没用，还可能在模块化（JPMS）环境下触发NoClassDefFoundError。
- 正确做法：直接
DriverManager.getConnection(url, user, pass)，驱动类由JDBC服务发现机制自动注册 - 如果用HikariCP、Druid这类连接池，它们内部已处理驱动加载，你只需配URL和账号，不用碰
Driver类 - 唯一需要显式加载驱动的场景：某些老旧OSGi容器或自定义ClassLoader环境，普通Spring Boot/Web项目完全不用管
驱动包放对位置、URL参数对齐服务端配置、依赖范围写准——这三件事做错任意一件，都会表现为“连不上”“连上了查不出数据”“时间字段错位”。剩下就是检查MySQL用户权限、防火墙、bind-address这些基础设施问题了。
JavaStoryDevelop
下载
你接手一个需求时，是不是经常这样："改一个小字段 → 结果把不相关的代码也改了"、"需求说得很模糊 → 做着做着发现跑偏了"、"数据库加个字段 → 上线才发现漏了数据兼容"、"做了个新功能 → 一个月后自己都忘了当时怎么设计的"、"写到一半被中断 → 再回来不知道从哪继续"；这个 Skill 就是专门解决这些问题的。 它会自动探测你的项目环境（JDK、Spring Boot、ORM、数据库、前端框架），记在
