Java连接MySQL数据库配置与驱动测试

本文详细解析了Java项目中配置MySQL数据库连接的关键要点，涵盖JDBC驱动版本选择（强调mysql-connector-j 8.0.33+对JDK 17+/MySQL 8.0+的必要性）、Maven/Gradle依赖的正确声明方式（尤其强调runtime范围）、连接URL中不可省略的核心参数（useSSL=false、serverTimezone=UTC、allowPublicKeyRetrieval=true）及其背后的安全与时区逻辑，并明确指出Class.forName已过时、现代框架自动处理驱动加载等常见误区——帮你避开90%因环境配置不当导致的“连不上、查不出、时间错、乱码”等典型故障，直击生产级数据库集成的痛点与最佳实践。

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项目完全不用管

驱动包放对位置、URL参数对齐服务端配置、依赖范围写准——这三件事做错任意一件，都会表现为“连不上”“连上了查不出数据”“时间字段错位”。剩下就是检查MySQL用户权限、防火墙、bind-address这些基础设施问题了。

本篇关于《Java连接MySQL数据库配置与驱动测试》的介绍就到此结束啦，但是学无止境，想要了解学习更多关于文章的相关知识，请关注golang学习网公众号！