接手一个带着历史包袱的项目时，我最怕的不是业务逻辑绕，而是连个数据库都连不上。IDEA里明明是同一个MySQL，别人双击就出来了，我这边连驱动都加载失败，更别提把表内容打印出来看一眼。后来把两条路都摸透了——一条是IDEA自带的Database面板，图形化连库查数据；另一条是代码里的JDBC连接，程序跑起来之后把表内容打印到控制台。这两条路解决的问题完全不同，但很多人混在一起折腾，走了不少弯路。这篇就把IDEA连MySQL的完整过程、打印表内容的几种写法、以及我实测踩过的坑一次讲清楚，适合正在学Java连接数据库、或者被各种连接报错卡住的开发者参考。
1. 开工前先理清这三件事：服务、测试表和驱动
1.1 确认MySQL服务真的在跑
连接失败至少有三分之一是服务没启动，而不是代码写错。我先检查MySQL服务状态，在Windows下按Win + R输入services.msc，在服务列表里找名字类似MySQL80或mysql的项，看状态列是不是“正在运行”。如果没运行，右键启动，再把启动类型改成“自动”，免得重启电脑之后又要手动开。
除了看服务，我习惯用命令行快速验证一下数据库本身能不能接受连接。打开终端，执行：
mysql -u root -p输入密码后能进到mysql>提示符，说明服务正常、账号密码也对。这一步能过滤掉大量“代码没问题，是环境没起”的乌龙。如果连命令行都进不去，那先别碰IDEA，把这一步搞定再说。
1.2 准备一张能直观看到变化的测试表
很多人喜欢拿现成的业务库练手，但表里字段几十个，数据量又大，打印出来全是噪音，很难判断连接到底成没成功。我的建议是建一张干净简单的测试表，表名就用user_info，字段控制在四个以内：
CREATE DATABASE IF NOT EXISTS test_db DEFAULT CHARACTER SET utf8mb4; USE test_db; CREATE TABLE IF NOT EXISTS user_info ( id INT AUTO_INCREMENT PRIMARY KEY, username VARCHAR(50) NOT NULL, email VARCHAR(100), create_time TIMESTAMP DEFAULT CURRENT_TIMESTAMP ); INSERT INTO user_info (username, email) VALUES ('zhangsan', 'zs@example.com'), ('lisi', 'ls@example.com'), ('wangwu', 'ww@example.com');注意建库语句里我加了DEFAULT CHARACTER SET utf8mb4，这一步很关键。如果库的默认字符集是latin1，后面中文数据写入、读取都会出乱码，排查起来相当头疼。测试表里三行数据足够验证连接、查询、打印全流程了。
1.3 JDBC驱动版本怎么选才不给自己挖坑
驱动版本和MySQL版本不匹配，是另一个高频翻车点。MySQL 5.7推荐用5.1.49版本的驱动，MySQL 8.0以上推荐用8.0.33，两者的类名和URL参数有差异。判断自己MySQL版本的方式很简单，命令行登录后执行SELECT VERSION();，或者看服务名——MySQL80通常对应8.0。
这里有个容易忽略的变化：8.0版本的驱动依赖坐标从mysql:mysql-connector-java变成了com.mysql:mysql-connector-j，如果你在Maven仓库里搜mysql-connector-java搜不到新版，就是这个原因。驱动选错最典型的症状是：能编译、能跑，但运行时报ClassNotFoundException或者连接报错提示驱动类不存在。版本匹配这事不用过度纠结，记住“数据库什么版本，驱动就选对应大版本的最新小版本”就行。
2. 先用IDEA自带的Database面板把连接打通
2.1 打开面板并新建MySQL数据源
IDEA从2020版开始把数据库工具整合得很顺手了。窗口右侧边缘有Database标签页，点开就是数据库面板；如果没看到，用View -> Tool Windows -> Database打开。
在面板空白处点左上角的+，选Data Source，再选MySQL。这时候会弹出一个连接配置窗口，需要填主机、端口、用户名、密码。测试阶段我一般只填本机信息：
- Host：
127.0.0.1 - Port：
3306 - User：
root - Password：你自己的MySQL密码
- Database：可以先不填，连接成功后在左侧列表里手动选
test_db
点窗口下方的Test Connection按钮，第一次会弹一个提示框，说缺少驱动文件、需要下载，确认就行，IDEA会自动下载匹配的驱动。
2.2 填连接信息的参数细节
很多人卡在“Test Connection”这一步。填参数的时候有几个容易忽视的细节，提醒一下：
- Host尽量不要用
localhost，用127.0.0.1。有些机器上localhost会被解析成IPv6的::1，而MySQL默认监听IPv4，结果就是报连接拒绝。 - 端口确认是
3306。如果本机改过端口，这里必须填实际端口。 - 如果安装MySQL时为root设置了密码，填错一个字都会报
Access denied for user 'root'@'localhost'，而且这个报错信息有一定迷惑性，看起来像权限问题，实际上就是密码不对。 - URL栏会自动生成类似
jdbc:mysql://127.0.0.1:3306的地址，IDEA面板里基本不用手改，但你要能看懂它，因为后面代码连接用的就是同一套参数。
2.3 连接成功后怎么看表内容和跑SQL
连接成功后，左侧树形结构里能看到test_db数据库，展开Tables节点，user_info表就列在那里。双击表名，右侧会打开一个数据预览窗口，直接列出表里全部行数据。这个窗口还可以直接编辑单元格，改完点提交按钮生效，用于快速修数据很方便。
我更喜欢用的是面板里的Console（控制台）。在数据库面板上有个小图标，像终端窗口，点击会打开一个SQL编辑器，直接在里面写：
SELECT * FROM user_info;然后按Ctrl + Enter执行，结果会以表格形式展现在下方，列名、数据一目了然。平时写测试SQL我都在这跑，免得在代码里拼SQL然后还得跑一遍程序那么重。
2.4 面板方案解决不了什么
IDEA的Database面板确实强大，但它解决的是“人看数据”的问题。程序里读数据库、打印表内容，面板再方便也帮不上忙。很多初学者在面板里看到数据了，就以为“连接没问题”，然后跑到代码里又报错，就懵了。实际上两者走的路径不同：面板用的是IDEA自带的驱动和连接器，代码用的是项目里Maven依赖的驱动。面板能连上，只能说明MySQL服务、账号、网络是通的；代码连不上，问题大概率出在项目的驱动依赖或URL配置上。所以测试要分两层：面板验证环境通不通，代码验证程序能不能通。
3. Java代码连接MySQL：从六步曲到可复用的连接封装
3.1 Maven依赖的坐标和版本讲究
在项目里连接MySQL，第一件事是往pom.xml里加依赖。MySQL 8.0对应的依赖长这样：
<dependency> <groupId>com.mysql</groupId> <artifactId>mysql-connector-j</artifactId> <version>8.0.33</version> </dependency>如果你用的还是MySQL 5.7，依赖换成：
<dependency> <groupId>mysql</groupId> <artifactId>mysql-connector-java</artifactId> <version>5.1.49</version> </dependency>一个容易忽视的细节：依赖加完，IDEA的Maven面板里要确认它确实被下载下来了。右侧Maven窗口点刷新按钮（圆形箭头图标），展开External Libraries看看有没有对应的jar包。依赖没拉下来，代码写得再对也是ClassNotFoundException。
3.2 连接URL背后的参数到底影响了什么
JDBC连接的核心是一个URL字符串，格式是：
jdbc:mysql://主机地址:端口/数据库名?参数1=值1&参数2=值2我实际用的完整版是这样的：
jdbc:mysql://127.0.0.1:3306/test_db?useUnicode=true&characterEncoding=utf8&useSSL=false&serverTimezone=Asia/Shanghai&allowPublicKeyRetrieval=true这些参数看着多，其实各管一件事：
useUnicode=true和characterEncoding=utf8：保证中文能正确存取。少了这两个参数，写入中文会变乱码或直接报错。useSSL=false：本地开发时关闭SSL加密，减少握手开销。不关也行，但8.0默认会提示你建立SSL连接，控制台刷一堆警告。serverTimezone=Asia/Shanghai：指定服务器时区。少了它，8.0驱动连接时报时区错误，因为驱动拿不到数据库所在时区。allowPublicKeyRetrieval=true：配合MySQL 8.0默认的caching_sha2_password认证插件使用。不加这个参数，部分环境会报Public Key Retrieval is not allowed。
这些参数不是随便堆的，每一个背后都有对应的坑，我在第5章会结合报错现象仔细说排查链路。
3.3 最简六步曲：一段能跑通的JDBC代码
JDBC连接数据库的流程固定是六步，记住这六步，任何关系型数据库都能套用。下面这段代码是完整可运行的，我把每一步都注释了：
import java.sql.Connection; import java.sql.DriverManager; import java.sql.ResultSet; import java.sql.Statement; public class JdbcDemo { public static void main(String[] args) { // 第一步：注册驱动（MySQL 8.x的驱动类） String driver = "com.mysql.cj.jdbc.Driver"; // 第二步：指定连接URL、用户名、密码 String url = "jdbc:mysql://127.0.0.1:3306/test_db" + "?useUnicode=true&characterEncoding=utf8" + "&useSSL=false&serverTimezone=Asia/Shanghai" + "&allowPublicKeyRetrieval=true"; String user = "root"; String password = "你的密码"; Connection conn = null; Statement stmt = null; ResultSet rs = null; try { // 第三步：注册驱动 Class.forName(driver); // 第四步：获取连接 conn = DriverManager.getConnection(url, user, password); // 第五步：创建Statement并执行SQL stmt = conn.createStatement(); rs = stmt.executeQuery("SELECT id, username, email, create_time FROM user_info"); // 第六步：遍历结果集 while (rs.next()) { int id = rs.getInt("id"); String username = rs.getString("username"); String email = rs.getString("email"); String createTime = rs.getString("create_time"); System.out.println(id + " | " + username + " | " + email + " | " + createTime); } } catch (Exception e) { e.printStackTrace(); } finally { // 释放资源：先关ResultSet，再关Statement，最后关Connection try { if (rs != null) rs.close(); } catch (Exception ignored) {} try { if (stmt != null) stmt.close(); } catch (Exception ignored) {} try { if (conn != null) conn.close(); } catch (Exception ignored) {} } } }这段代码跑通，说明程序到数据库的通路已经建立了。finally里的资源释放很多人会偷懒省略，但连接不关闭，长时间运行会耗尽数据库连接数，程序就假死了。不管再怎么强调都不为过。
3.4 把连接抽成工具类：static块和连接池的取舍
上面的写法演示原理可以，但每个地方都写一遍DriverManager.getConnection，代码冗余还容易漏关资源。稍微正规点的项目，我一般抽一个工具类：
import java.sql.Connection; import java.sql.DriverManager; import java.sql.SQLException; public class DbUtil { private static final String URL = "jdbc:mysql://127.0.0.1:3306/test_db" + "?useUnicode=true&characterEncoding=utf8" + "&useSSL=false&serverTimezone=Asia/Shanghai" + "&allowPublicKeyRetrieval=true"; private static final String USER = "root"; private static final String PASSWORD = "你的密码"; static { try { Class.forName("com.mysql.cj.jdbc.Driver"); } catch (ClassNotFoundException e) { throw new ExceptionInInitializerError(e); } } public static Connection getConnection() throws SQLException { return DriverManager.getConnection(URL, USER, PASSWORD); } }注意static块：类被加载时只执行一次驱动注册，不需要每次连接都Class.forName。不过这里要说实话——mysql-connector-j的驱动在8.0版本后支持SPI机制，DriverManager能自动发现驱动类，Class.forName其实可以省略。我保留它是为了兼容老版本的数据库和环境，同时也让代码意图更明确。
还有一个建议留给稍有经验的人：如果项目里多个地方要频繁连库，别用上面的直连方式，换成连接池。连接池的核心价值是复用连接，避免每次请求都经历“建连接→断连接”的完整开销。我用得最多的是HikariCP，配置起来很简洁：
<dependency> <groupId>com.zaxxer</groupId> <artifactId>HikariCP</artifactId> <version>5.1.0</version> </dependency>HikariConfig config = new HikariConfig(); config.setJdbcUrl(URL); config.setUsername(USER); config.setPassword(PASSWORD); config.setMaximumPoolSize(10); HikariDataSource dataSource = new HikariDataSource(config); Connection conn = dataSource.getConnection();个人开发、教学练习用直连就好，简单直接；公司项目、生产部署一定要用连接池，这是两个完全不同的场景，别混为一谈。
4. 打印数据库表内容：从固定字段到通用打印工具
4.1 什么样的“打印”才算真能帮上忙
标题里说的“测试打印数据库表内容”，看起来简单，但不同场景对打印的要求完全不同。我先拆个需求：
- 最低要求：查出表里所有数据，在控制台能看到每一行的值。
- 进阶要求：列名也要打出来，并且能识别表里有多少列。
- 实用要求：不管哪张表，传入表名就能打印，不用每次改代码。
只求“看到数据”，写死字段名是最快的；但如果你想拿这个能力当测试辅助工具，就应该做成通用的，后面随便换了表都不用动代码。下面按这个思路，从低到高给三个版本的写法。
4.2 第一版：针对固定表的简单输出
这版最直接，把上一章Demo里的while循环打印部分稍作调整：
while (rs.next()) { System.out.println( "id=" + rs.getInt("id") + ", username=" + rs.getString("username") + ", email=" + rs.getString("email") + ", createTime=" + rs.getString("create_time") ); }输出效果类似：
id=1, username=zhangsan, email=zs@example.com, createTime=2024-03-15 10:00:00 id=2, username=lisi, email=ls@example.com, createTime=2024-03-16 12:30:00 id=3, username=wangwu, email=ww@example.com, createTime=2024-03-17 09:45:00好处是字段名写死，IDE有自动补全，基本不会拼错；坏处是表结构一变，代码就得跟着改，维护成本高。适合一次性临时调试。
4.3 第二版：用ResultSetMetaData动态读取列数
JDBC里有个ResultSetMetaData对象，它记录了结果集的元信息，也就是列的数量、列名、列类型。用它能实现“不管SELECT查出了什么列，我都能动态打出来”。
ResultSetMetaData metaData = rs.getMetaData(); int columnCount = metaData.getColumnCount(); System.out.println("列数量: " + columnCount); for (int i = 1; i <= columnCount; i++) { System.out.print(metaData.getColumnName(i) + "\t"); } System.out.println(); while (rs.next()) { for (int i = 1; i <= columnCount; i++) { System.out.print(rs.getString(i) + "\t"); } System.out.println(); }别小看这个rs.getString(i)——它传的是列序号，从1开始数，不是列索引从0开始。这里下标写错，是所有新手必踩的坑。用下标取值的好处是，就算不知道列名，也能把值取出来，配合元数据刚刚好。
4.4 第三版：随便哪张表都能打的通用方法
把第二版的逻辑封装成一个方法，参数改为Connection和表名：
import java.sql.Connection; import java.sql.ResultSet; import java.sql.ResultSetMetaData; import java.sql.Statement; public class TablePrinter { public static void printTable(Connection conn, String tableName) { String sql = "SELECT * FROM " + tableName; try (Statement stmt = conn.createStatement(); ResultSet rs = stmt.executeQuery(sql)) { ResultSetMetaData metaData = rs.getMetaData(); int columnCount = metaData.getColumnCount(); // 打印表头 for (int i = 1; i <= columnCount; i++) { System.out.print(metaData.getColumnName(i) + "\t"); } System.out.println(); System.out.println("----------------------------------------"); // 打印数据行 while (rs.next()) { for (int i = 1; i <= columnCount; i++) { System.out.print(rs.getString(i) + "\t"); } System.out.println(); } } catch (Exception e) { e.printStackTrace(); } } }调用方式很简单：
Connection conn = DbUtil.getConnection(); TablePrinter.printTable(conn, "user_info");注意这里用了try-with-resources语法，Statement和ResultSet用完后自动关闭，不需要手动写finally块，代码清爽很多。连接conn是外面传进来的，所以不在这里关，由调用方决定何时释放。这个设计是刻意的——同一个连接可以连续打印多张表，如果方法里把连接也关了，第二次调用就得重新拿连接。
4.5 实测效果与输出形态
我用上面的通用方法打印user_info表，控制台输出是这样的：
id username email create_time ---------------------------------------- 1 zhangsan zs@example.com 2024-03-15 10:00:00 2 lisi ls@example.com 2024-03-16 12:30:00 3 wangwu ww@example.com 2024-03-17 09:45:00字段之间用制表符\t分隔，比逗号拼接更整齐。制表符的宽度在控制台是等宽的，所以列基本对得齐。想再精细一点可以计算每列最大宽度再填充空格，但对测试打印来说，制表符方案胜在简单，够用了。
5. 五大高频问题排查记录（附完整链路）
5.1 报ClassNotFoundException：先看依赖有没有进去
现象是运行代码时控制台第一行报：
java.lang.ClassNotFoundException: com.mysql.cj.jdbc.Driver我先看一眼异常栈指向哪一行，通常就是Class.forName(driver)这句。第一步去pom.xml确认依赖坐标有没有加对，External Libraries里搜不搜得到mysql相关的jar。
排查时我发现一个容易忽略的地方：IDEA有时候会自动缓存旧的依赖树。如果pom.xml刚改完，右下角弹提示问要不要Import Changes，点了没反应，就在Maven工具窗口点刷新按钮强制重新加载。如果刷新后还没有，检查Maven仓库路径下有没有下载失败留下的.lastUpdated文件，有的话把对应目录清掉重新拉取。还有一种可能是依赖加进了pom.xml但scope被误设为provided或test，导致运行主程序时classpath里根本没有它。我在某次接手项目时就见过依赖被设成provided导致本地能编译不能运行的情况。
5.2 报Communications link failure：逐项排查链路
常见报错是：
com.mysql.cj.jdbc.exceptions.CommunicationsException: Communications link failure这个提示的意思是“和数据库没建立起底层网络连接”。链路各段多长就多长，一段段测：
第一步，确认MySQL服务活着。打开services.msc，找MySQL服务，状态必须是“正在运行”。这一步过滤掉一半以上的问题。
第二步，确认端口能通。在终端执行：
netstat -ano | findstr 3306能看到LISTENING状态的一行，说明MySQL正在监听3306端口。如果这里看不到任何输出，说明MySQL可能没监听这个端口，或者监听的是别的端口。我遇到过MySQL默认端口被改成3307的情况，URL里还写3306，自然连不上。
第三步，确认URL的主机和端口与实际一致。localhost解析出问题，就换成127.0.0.1。远程连接的话，还要确认防火墙放行了3306端口。
排查这类问题最忌讳的就是猜，看到报错就怀疑代码。我一般按“服务→端口→URL参数→账号密码”这个顺序来，基本一两分钟就能定位。
5.3 时区报错与中文乱码：URL参数的连锁反应
MySQL 8.0连接时报错的经典场景是这个：
The server time zone value 'Öйú±ê׼ʱ¼ä' is unrecognized or represents more than one time zone.注意报错信息里那一串乱码一样的字符。它其实是“中国标准时间”的乱码形态。原因是驱动在建立连接时，需要获取数据库所在时区，而数据库默认时区在驱动这里识别失败。
解决办法就是在URL里显式加参数：
serverTimezone=Asia/Shanghai改完这个，时区报错消失。紧接着又可能冒出另一个问题：查出来的中文全是?。这个就是字符集问题，对应URL里的：
useUnicode=true&characterEncoding=utf8加进去之后，重新跑一遍，中文就正常了。时区和字符集两个问题经常一起出现，因为它们在URL里都是参数配置，少一个就会在某个环节暴露出来。我建议从一开始就把这串参数完整写进连接URL，不要等报错了再往回补。
5.4 报Access denied：账号权限还是密码问题
出现java.sql.SQLException: Access denied for user 'root'@'localhost'时，我第一反应是密码错了。用命令行验证一下：mysql -u root -p，能进说明密码没问题，那就不是密码的事。
接下来查权限。在命令行执行：
SELECT user, host, plugin FROM mysql.user WHERE user = 'root';重点看host列。如果root只允许localhost登录，而你代码里连接的URL写的是127.0.0.1，MySQL会把它当另一个主机对待，在权限表里找不到对应记录，于是拒绝访问。解决办法是给root增加一个允许通过127.0.0.1连接的授权：
CREATE USER 'root'@'127.0.0.1' IDENTIFIED BY '你的密码'; GRANT ALL PRIVILEGES ON *.* TO 'root'@'127.0.0.1' WITH GRANT OPTION; FLUSH PRIVILEGES;另一个坑是MySQL 8.0默认认证插件是caching_sha2_password，旧版驱动不认这种认证方式，也会报错。要么升级驱动版本到8.0+，要么在URL里加allowPublicKeyRetrieval=true。
5.5 多个驱动版本并存：Maven仲裁导致的运行错位
这个坑比较隐蔽。项目里有多个模块依赖，其中两个模块分别引了mysql-connector-java:5.1.49和mysql-connector-j:8.0.33，Maven仲裁规则会选较近的声明或较新的版本，最终只有一个jar进classpath。如果选了5.1.49，代码里com.mysql.cj.jdbc.Driver这个类不存在，因为老驱动包里的类名是com.mysql.jdbc.Driver，结果就是ClassNotFoundException，但你在pom.xml里明明加的是新依赖。
排查手段是在Maven工具窗口运行mvn dependency:tree，直接看最终的依赖树，确认实际生效的驱动是哪个版本。然后统一版本，把项目里所有mysql驱动的引用收敛到一个版本，避免互相干扰。这个坑我只遇到过一次，但排查耗了大半天，特别有印象。
最后分享一点个人体会
把“打印数据库表内容”这个能力养成习惯之后，我验证任何数据库相关的改动都快了很多。新接一个项目，先跑一遍TablePrinter.printTable(conn, "某张表")，表结构对不对、数据有没有同步、编码乱不乱，几分钟全摸清。再分享一个小技巧：连接信息别硬编码在代码里，放到application.properties或环境变量中，比如db.url、db.username、db.password，代码只负责读取配置。好处是换环境不用改代码，也避免密码被提交到版本控制里。这不算什么高深技术，但在实际项目里能帮你省掉很多不必要的烦恼。
