1. 项目概述为什么JDBC连接MySQL 8.0是个“新”问题如果你是一个刚开始接触Java后端开发的新手或者是一个从老项目迁移过来的开发者最近在尝试用JDBC连接MySQL 8.0或更高版本时大概率会碰到一些让你挠头的错误。比如你可能会遇到经典的java.sql.SQLException: The server time zone value ‘XXXXX’ is unrecognized或者更让人困惑的Public Key Retrieval is not allowed。这些错误在连接MySQL 5.7时可能闻所未闻但到了8.0时代它们成了拦路虎。这背后的原因正是MySQL 8.0在安全性和默认配置上做出了重大调整而很多网上的“祖传”教程和代码片段还没来得及更新。所以今天这篇内容我想从一个一线开发者的角度从头到尾、手把手地带你搭建一个能稳稳连接MySQL 8.0的Java开发环境。这不仅仅是“安装软件-写代码”的流水账我会重点拆解那些版本升级带来的“坑”并解释每一步操作背后的“为什么”。无论你是想快速跑通第一个数据库程序的学生还是需要为团队统一开发环境的技术负责人这篇内容都能给你提供一套经过验证的、可复现的实操方案。2. 环境准备选对版本事半功倍搭建环境的第一步不是盲目下载最新版而是理解组件之间的兼容性。一个稳定的开发环境往往是“合适”大于“最新”。2.1 核心组件选型与下载我们需要三个核心组件Java Development Kit (JDK)、MySQL数据库、以及一个集成开发环境IDE。它们的版本搭配有讲究。1. JDK的选择对于大多数企业级Java应用我推荐选择JDK 11 (LTS)或JDK 17 (LTS)。LTS代表长期支持意味着有更稳定的更新和商业支持。MySQL 8.0的官方驱动对JDK 8及以上版本兼容良好。但请注意如果你或你的项目未来考虑使用更新的框架如Spring Boot 3.x其最低要求是JDK 17那么直接从JDK 17开始会更省心。这里我以JDK 11为例进行演示因为它目前仍然是应用最广泛的LTS版本之一。注意避免在正式开发环境中使用非LTS版本如JDK 18, 19, 20它们仅提供6个月的支持可能引入不预期的变更。2. MySQL 8.0的下载直接访问MySQL官方网站的下载页面。这里有个关键选择是下载MySQL InstallerWindows推荐还是压缩包macOS/Linux推荐。对于开发者我强烈建议选择MySQL Community Server的ZIP压缩包Windows或TAR包Linux/macOS。理由很简单Installer虽然方便但会安装很多你可能用不到的组件如MySQL Workbench, Router等并且其安装路径和配置方式有时不够透明出了问题更难排查。压缩包则干净、可控适合学习和高阶配置。下载时注意选择正确的操作系统和架构通常是x86_64。版本号选择8.0的最新小版本如8.0.36小版本修复了很多Bug并提升了性能。3. IDE的选择IntelliJ IDEA Community Edition免费是当前Java开发的事实标准其智能提示、代码分析和数据库工具集成远超其他同类产品。Eclipse也是一个选择但就开发效率和体验而言IDEA的优势非常明显。我们将使用IDEA进行后续的编码和依赖管理。2.2 安装与基础配置实操JDK安装与环境变量配置运行下载的JDK安装程序记住安装路径例如C:\Program Files\Java\jdk-11.0.xx。配置系统环境变量JAVA_HOME新建变量值设为JDK的安装路径如上例。Path编辑添加%JAVA_HOME%\bin。验证打开命令行输入java -version和javac -version应正确显示版本号。MySQL 8.0 安装与初始化以Windows ZIP包为例解压ZIP包到你想要的目录例如D:\DevTools\mysql-8.0.36-winx64。在该目录下新建一个my.ini配置文件。这是MySQL 8.0自定义配置的关键。[mysqld] # 设置3306端口 port3306 # 设置mysql的安装目录你自己的路径 basedirD:/DevTools/mysql-8.0.36-winx64 # 设置mysql数据库的数据的存放目录你自己的路径 datadirD:/DevTools/mysql-8.0.36-winx64/data # 允许最大连接数 max_connections200 # 允许连接失败的次数。这是为了防止有人从该主机试图攻击数据库系统 max_connect_errors10 # 服务端使用的字符集默认为UTF8 character-set-serverutf8mb4 # 创建新表时将使用的默认存储引擎 default-storage-engineINNODB # 默认使用“mysql_native_password”插件认证 default_authentication_pluginmysql_native_password [mysql] # 设置mysql客户端默认字符集 default-character-setutf8mb4 [client] # 设置mysql客户端连接服务端时默认使用的端口和字符集 port3306 default-character-setutf8mb4重点参数解读datadir指定数据存放目录。初始化后所有数据库文件都会在这里。character-set-serverutf8mb4MySQL 8.0默认已是utf8mb4但显式声明可避免任何不确定性。utf8mb4才是真正的全UTF-8支持能存储emoji等字符。default_authentication_pluginmysql_native_password这是连接8.0的关键之一。MySQL 8.0默认使用了更安全的caching_sha2_password插件但一些老的客户端或驱动可能不支持。设为mysql_native_password可以最大程度兼容后续在JDBC连接时也会更简单。当然你也可以选择适配新的插件这会在后面JDBC连接部分详细说明。初始化数据库以管理员身份打开命令行进入MySQL的bin目录。cd D:\DevTools\mysql-8.0.36-winx64\bin mysqld --initialize --console执行后控制台会输出一个临时密码务必复制保存它长这样[Note] [MY-010454] [Server] A temporary password is generated for rootlocalhost: 3sjaKslq0we。最后那串字符就是密码。安装MySQL服务mysqld --install MySQL启动服务并修改密码net start MySQL mysql -u root -p输入刚才保存的临时密码。登录成功后立即修改密码ALTER USER rootlocalhost IDENTIFIED BY 你的新密码; FLUSH PRIVILEGES;至此MySQL服务已安装并运行。3. 项目创建与依赖管理环境就绪后我们开始在IntelliJ IDEA中创建项目并引入连接MySQL所需的“桥梁”——JDBC驱动。3.1 创建Maven项目与驱动引入现代Java项目几乎都使用Maven或Gradle来管理依赖这比手动下载JAR包要优雅和可靠得多。打开IntelliJ IDEA选择“New Project”。左侧选择“Maven”确保JDK是你刚安装的版本如11点击“Next”。填写GroupId如com.example、ArtifactId如jdbc-demo然后“Finish”。项目创建好后打开根目录下的pom.xml文件。在dependencies标签内添加MySQL Connector/J的依赖。dependencies !-- MySQL JDBC 驱动 -- dependency groupIdmysql/groupId artifactIdmysql-connector-java/artifactId version8.0.33/version !-- 使用与你的MySQL服务器匹配的版本 -- /dependency /dependencies版本选择心得驱动版本最好与你的MySQL服务器大版本一致或略新。例如MySQL Server是8.0.36驱动可以用8.0.33。你可以去Maven中央仓库搜索mysql-connector-java查看最新稳定版。添加依赖后IDEA通常会自动开始下载。如果没有可以点击右侧Maven工具栏的刷新按钮。3.2 理解JDBC驱动与MySQL 8.0的认证插件添加了依赖事情只完成了一半。关键在于理解这个驱动如何与MySQL 8.0的新特性交互。前面我们在my.ini里设置了default_authentication_pluginmysql_native_password这是一种兼容性选择。实际上MySQL 8.0推荐使用的是caching_sha2_password插件它更安全。mysql-connector-java从8.0版本开始已经原生支持这个新插件。这意味着如果你的MySQL用户使用了caching_sha2_password我们的Java驱动也能连接但可能需要额外的连接参数。那么该如何选择场景一追求最大兼容性学习、内部工具、老环境迁移。就像我们刚才做的在MySQL服务端配置default_authentication_pluginmysql_native_password并且创建用户时也使用该插件。这样任何兼容旧版MySQL的客户端都能连接包括我们即将编写的JDBC程序。连接URL简单。场景二拥抱新标准新项目、注重安全。使用默认的caching_sha2_password插件。这要求JDBC连接URL中必须指定正确的参数否则会报Public Key Retrieval is not allowed错误。为了让你彻底掌握下面的实操部分我将分别演示这两种方式如何连接。这是处理MySQL 8.0连接问题的核心。4. 核心代码实现与连接参数详解现在我们来编写真正的JDBC代码。我会先创建一个工具类来管理连接然后分别展示两种认证插件下的连接方法。4.1 编写数据库连接工具类在src/main/java下创建包和类例如com.example.jdbcdemo.util.DatabaseConnection。package com.example.jdbcdemo.util; import java.sql.Connection; import java.sql.DriverManager; import java.sql.SQLException; public class DatabaseConnection { // 数据库连接信息 - 使用 mysql_native_password 插件兼容模式 private static final String JDBC_URL_COMPAT jdbc:mysql://localhost:3306/your_database?useUnicodetruecharacterEncodingutf8useSSLfalseserverTimezoneAsia/Shanghai; // 数据库连接信息 - 使用 caching_sha2_password 插件现代安全模式 private static final String JDBC_URL_MODERN jdbc:mysql://localhost:3306/your_database?useUnicodetruecharacterEncodingutf8useSSLfalseserverTimezoneAsia/ShanghaiallowPublicKeyRetrievaltrue; private static final String USER root; private static final String PASSWORD 你的密码; /** * 获取一个数据库连接兼容模式对应mysql_native_password插件 * return Connection 对象 */ public static Connection getConnectionCompat() { Connection conn null; try { // 在较新的驱动中这行可以省略驱动管理器会自动加载 // Class.forName(com.mysql.cj.jdbc.Driver); conn DriverManager.getConnection(JDBC_URL_COMPAT, USER, PASSWORD); System.out.println(数据库连接成功兼容模式); } catch (SQLException e) { System.err.println(连接失败兼容模式:); e.printStackTrace(); } return conn; } /** * 获取一个数据库连接现代模式对应caching_sha2_password插件 * return Connection 对象 */ public static Connection getConnectionModern() { Connection conn null; try { conn DriverManager.getConnection(JDBC_URL_MODERN, USER, PASSWORD); System.out.println(数据库连接成功现代模式); } catch (SQLException e) { System.err.println(连接失败现代模式:); e.printStackTrace(); } return conn; } /** * 关闭数据库连接 * param conn 要关闭的连接 */ public static void closeConnection(Connection conn) { if (conn ! null) { try { conn.close(); System.out.println(数据库连接已关闭); } catch (SQLException e) { e.printStackTrace(); } } } }4.2 连接URL参数逐行解析连接字符串JDBC URL里的每一个参数都至关重要理解它们能帮你解决90%的连接问题。jdbc:mysql://localhost:3306/your_database这是基本格式指定了协议、子协议、主机、端口和具体的数据库名。在连接前你需要先在MySQL中创建这个数据库CREATE DATABASE your_database;。useUnicodetruecharacterEncodingutf8确保客户端和服务端之间的字符传递使用Unicode并以UTF-8编码。强烈建议始终开启避免中文乱码。useSSLfalse在本地开发环境我们通常不配置SSL证书所以设为false以简化连接。在生产环境中为了安全必须设置为true并配置正确的证书。serverTimezoneAsia/Shanghai这是解决“时区错误”的关键MySQL 8.0对时区检查更加严格。如果JDBC客户端你的Java程序的时区与MySQL服务器设置的时区不匹配就会抛出The server time zone value ‘XXXXX’ is unrecognized异常。这个参数显式地告诉驱动使用哪个时区去和服务器通信。Asia/Shanghai代表东八区。你也可以用UTC。allowPublicKeyRetrievaltrue这是连接使用caching_sha2_password插件用户时必须的参数当使用新的认证插件时驱动可能需要从服务器获取RSA公钥来加密密码。这个参数允许此行为。注意官方文档提示在某些安全策略下允许公钥检索可能存在风险。但在开发环境或受信任的网络中这是必要的。如果使用mysql_native_password插件则不需要此参数。4.3 两种认证模式的MySQL用户配置你的Java程序连接哪个用户决定了你需要用哪种URL和参数。配置用户使用 mysql_native_password (兼容模式)在MySQL命令行中执行-- 创建一个新用户并指定使用旧版插件 CREATE USER dev_userlocalhost IDENTIFIED WITH mysql_native_password BY user_password; -- 授予该用户对your_database数据库的所有权限 GRANT ALL PRIVILEGES ON your_database.* TO dev_userlocalhost; FLUSH PRIVILEGES;然后在Java代码中将USER和PASSWORD常量替换为dev_user和user_password并使用getConnectionCompat()方法即不包含allowPublicKeyRetrieval的URL。配置用户使用 caching_sha2_password (现代模式)MySQL 8.0创建用户的默认插件就是它。-- 直接创建用户默认就是 caching_sha2_password CREATE USER secure_userlocalhost IDENTIFIED BY secure_password; GRANT ALL PRIVILEGES ON your_database.* TO secure_userlocalhost; FLUSH PRIVILEGES;在Java代码中将USER和PASSWORD替换为secure_user和secure_password并使用getConnectionModern()方法即包含allowPublicKeyRetrievaltrue的URL。5. 执行SQL与资源管理获取连接后我们来执行一些基本的SQL操作并强调一个至关重要的开发习惯资源管理。5.1 基础的CRUD操作示例创建一个测试类JdbcCrudDemo演示增删改查。package com.example.jdbcdemo; import com.example.jdbcdemo.util.DatabaseConnection; import java.sql.*; public class JdbcCrudDemo { public static void main(String[] args) { Connection conn null; Statement stmt null; PreparedStatement pstmt null; ResultSet rs null; try { // 1. 获取连接这里使用兼容模式示例 conn DatabaseConnection.getConnectionCompat(); if (conn null) return; // 2. 创建Statement对象执行DDL创建表 stmt conn.createStatement(); String createTableSQL CREATE TABLE IF NOT EXISTS users ( id INT AUTO_INCREMENT PRIMARY KEY, name VARCHAR(100) NOT NULL, email VARCHAR(100) UNIQUE, created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP ) ENGINEInnoDB DEFAULT CHARSETutf8mb4; stmt.executeUpdate(createTableSQL); System.out.println(表users创建成功或已存在。); // 3. 使用PreparedStatement执行INSERT防止SQL注入 String insertSQL INSERT INTO users (name, email) VALUES (?, ?); pstmt conn.prepareStatement(insertSQL); pstmt.setString(1, 张三); pstmt.setString(2, zhangsanexample.com); int rowsInserted pstmt.executeUpdate(); System.out.println(插入了 rowsInserted 行数据。); // 4. 执行UPDATE pstmt.close(); // 关闭之前的PreparedStatement String updateSQL UPDATE users SET email ? WHERE name ?; pstmt conn.prepareStatement(updateSQL); pstmt.setString(1, zhangsan_newexample.com); pstmt.setString(2, 张三); int rowsUpdated pstmt.executeUpdate(); System.out.println(更新了 rowsUpdated 行数据。); // 5. 执行QUERY pstmt.close(); stmt.close(); // 关闭之前的Statement String querySQL SELECT id, name, email, created_at FROM users; stmt conn.createStatement(); rs stmt.executeQuery(querySQL); System.out.println(\n查询结果); System.out.println(ID\tName\tEmail\t\t\tCreated At); while (rs.next()) { int id rs.getInt(id); String name rs.getString(name); String email rs.getString(email); Timestamp createdAt rs.getTimestamp(created_at); System.out.printf(%d\t%s\t%s\t%s\n, id, name, email, createdAt); } // 6. 执行DELETE演示用实际慎用 pstmt conn.prepareStatement(DELETE FROM users WHERE name ?); pstmt.setString(1, 张三); int rowsDeleted pstmt.executeUpdate(); System.out.println(\n删除了 rowsDeleted 行数据。); } catch (SQLException e) { e.printStackTrace(); } finally { // 6. 关键在finally块中按顺序关闭资源 try { if (rs ! null) rs.close(); } catch (SQLException e) { e.printStackTrace(); } try { if (pstmt ! null) pstmt.close(); } catch (SQLException e) { e.printStackTrace(); } try { if (stmt ! null) stmt.close(); } catch (SQLException e) { e.printStackTrace(); } try { if (conn ! null) DatabaseConnection.closeConnection(conn); } catch (Exception e) { e.printStackTrace(); } } } }5.2 资源管理为什么必须关闭Connection, Statement, ResultSet这是JDBC编程中最容易忽视也最容易导致严重问题的地方。数据库连接Connection是昂贵的资源数据库服务器对其数量有严格限制。如果每个操作都不关闭连接很快就会耗尽连接池导致新的请求无法连接这就是“连接泄漏”。关闭顺序必须遵循ResultSet - Statement/PreparedStatement - Connection的顺序。因为Statement依赖于ConnectionResultSet依赖于Statement。后创建的先关闭。现代最佳实践Try-with-Resources从Java 7开始强烈推荐使用try-with-resources语法它可以自动关闭实现了AutoCloseable接口的资源代码更简洁也更安全。// 使用try-with-resources重写查询部分 String querySQL SELECT id, name FROM users; try (Connection conn DatabaseConnection.getConnectionCompat(); Statement stmt conn.createStatement(); ResultSet rs stmt.executeQuery(querySQL)) { while (rs.next()) { System.out.println(rs.getInt(id) : rs.getString(name)); } } catch (SQLException e) { e.printStackTrace(); }在try后的括号里声明资源无论是否发生异常在try块结束后它们都会被自动关闭顺序正确无误。这是处理JDBC资源的首选方式。6. 高级话题与生产环境考量当你掌握了基础连接和CRUD后在实际项目中你很快就会遇到更复杂的需求。6.1 使用数据库连接池如HikariCP在任何一个严肃的应用程序中直接使用DriverManager.getConnection()都是不合适的。每次操作都建立和关闭物理连接开销巨大。连接池负责管理一组预先建立好的连接应用程序从池中借用和归还连接极大地提升了性能。HikariCP是目前性能最好的JDBC连接池之一。在Maven项目中引入dependency groupIdcom.zaxxer/groupId artifactIdHikariCP/artifactId version5.0.1/version /dependency然后改造我们的DatabaseConnection工具类package com.example.jdbcdemo.util; import com.zaxxer.hikari.HikariConfig; import com.zaxxer.hikari.HikariDataSource; import javax.sql.DataSource; import java.sql.Connection; import java.sql.SQLException; public class DatabaseConnectionPool { private static final HikariDataSource dataSource; static { HikariConfig config new HikariConfig(); // 核心配置 config.setJdbcUrl(jdbc:mysql://localhost:3306/your_database?useUnicodetruecharacterEncodingutf8useSSLfalseserverTimezoneAsia/ShanghaiallowPublicKeyRetrievaltrue); config.setUsername(secure_user); config.setPassword(secure_password); // 连接池优化配置根据实际情况调整 config.setMaximumPoolSize(10); // 最大连接数 config.setMinimumIdle(5); // 最小空闲连接 config.setIdleTimeout(600000); // 空闲连接超时时间毫秒 config.setConnectionTimeout(30000); // 获取连接的超时时间 config.setMaxLifetime(1800000); // 连接的最大生命周期 // MySQL驱动特定的优化配置 config.addDataSourceProperty(cachePrepStmts, true); config.addDataSourceProperty(prepStmtCacheSize, 250); config.addDataSourceProperty(prepStmtCacheSqlLimit, 2048); dataSource new HikariDataSource(config); } public static Connection getConnection() throws SQLException { return dataSource.getConnection(); } public static DataSource getDataSource() { return dataSource; } public static void closePool() { if (dataSource ! null !dataSource.isClosed()) { dataSource.close(); } } }使用连接池后你的业务代码中获取连接的方式不变但性能、稳定性和资源管理能力得到了质的飞跃。记得在应用关闭时例如通过Servlet上下文监听器调用closePool()方法。6.2 时区问题的深度剖析与全局解决方案前面我们通过在JDBC URL中添加serverTimezone参数解决了时区问题。但这个问题有更深的根源。问题本质Java程序运行的JVM有一个默认时区MySQL服务器也有一个系统时区和会话时区。当Java程序将一个java.util.Date或java.time.LocalDateTime对象存入MySQL的TIMESTAMP或DATETIME字段时驱动需要知道如何进行转换。如果双方时区信息不明确或不匹配就会导致存入或读出的时间出现几小时的偏差。更彻底的解决方案统一服务器时区在MySQL配置文件my.ini或my.cnf的[mysqld]部分设置default-time-zone ‘08:00‘。这确保了MySQL服务本身使用东八区。统一应用时区在Java应用启动时设置JVM的默认时区。可以在启动命令中添加参数-Duser.timezoneAsia/Shanghai或者在应用启动代码中设置TimeZone.setDefault(TimeZone.getTimeZone(Asia/Shanghai))。JDBC参数兜底最后在JDBC URL中依然保留serverTimezoneAsia/Shanghai作为明确声明。三层保障下来时区问题基本可以绝迹。对于新项目我建议在服务器和JVM层面就做好统一配置。7. 常见问题排查与调试技巧即使按照步骤操作你可能还是会遇到问题。这里记录了几个最常见的“坑”和排查思路。7.1 连接失败问题速查表错误信息或现象可能原因解决方案java.sql.SQLException: The server time zone value ‘XXXXX’ is unrecognized未指定服务器时区或时区字符串不被识别。在JDBC URL中添加serverTimezoneAsia/Shanghai(或UTC)。java.sql.SQLNonTransientConnectionException: Public Key Retrieval is not allowed用户使用caching_sha2_password认证但未允许驱动获取公钥。在JDBC URL中添加allowPublicKeyRetrievaltrue。或者将用户认证插件改为mysql_native_password。java.sql.SQLException: Access denied for user ‘root’‘localhost’ (using password: YES)用户名或密码错误用户没有从localhost登录的权限。检查密码是否正确注意大小写。尝试用MySQL命令行登录验证。或者检查用户主机权限SELECT user, host FROM mysql.user;Communications link failure/Connection refusedMySQL服务未启动端口被防火墙阻挡连接地址或端口错误。1. 运行net start MySQL(Windows) 或systemctl start mysqld(Linux) 启动服务。2. 检查连接URL中的主机名(localhost)和端口(3306)是否正确。3. 检查防火墙是否放行了3306端口。No suitable driver found for jdbc:mysql://...JDBC驱动未正确加载。1. 检查pom.xml依赖是否正确添加并已下载。2. 对于非Maven项目确保mysql-connector-java-8.0.xx.jar在项目的类路径(Classpath)中。3. 在极老的项目或特定容器中可能需要显式调用Class.forName(“com.mysql.cj.jdbc.Driver”);。插入或查询中文出现乱码数据库、表和连接字符集不统一。1. 确保数据库、表、字段的字符集为utf8mb4。2.确保JDBC URL中包含useUnicodetruecharacterEncodingutf8。3. 检查客户端如命令行、IDE的字符集设置。7.2 实用的调试与日志技巧开启MySQL通用查询日志当问题极其诡异怀疑SQL根本没发到数据库时可以在MySQL中临时开启通用查询日志生产环境慎用。SET GLOBAL general_log ‘ON‘; SET GLOBAL log_output ‘FILE‘; -- 或 ‘TABLE‘执行你的Java程序然后去MySQL数据目录datadir查看日志文件确认连接和SQL语句是否如期到达服务器。在JDBC URL中开启驱动调试添加参数loggerSlf4JLoggerprofileSQLtrue。这需要你的项目有SLF4J和其实现如Logback的依赖。开启后驱动会输出详细的连接过程和SQL执行日志对排查超时、认证问题非常有帮助。使用网络工具排查如果怀疑是网络问题可以使用telnet localhost 3306命令测试是否能连接到MySQL的端口。如果连接失败说明是服务或网络层面的问题。验证用户权限有时密码对了但用户没有访问特定数据库的权限。在MySQL中执行SHOW GRANTS FOR ‘your_user’‘localhost’;确保输出中包含对你目标数据库的权限例如GRANT ALL PRIVILEGES ON your_database.* TO ...。搭建和配置的过程其实就是不断遇到问题、理解问题、解决问题的过程。MySQL 8.0在安全上的强化起初给开发者带来了一些麻烦但一旦理解了其背后的原理新的认证插件、严格的时区并掌握了对应的配置方法连接参数、用户插件这些“麻烦”就变成了构建更健壮应用的知识基石。从最基础的DriverManager连接到使用高性能的HikariCP连接池从手写资源关闭到使用try-with-resources这套环境搭建和编码规范足以支撑你开始大多数基于Java和MySQL的后端开发工作。记住在开发中明确每行配置和代码的意图远比盲目复制粘贴来得重要。
