jdbc报错90%源于客户端配置或代码问题，需按驱动加载、连接建立、sql执行、资源管理四层排查：驱动类名错、url参数缺、锁超时、sql拼接误、资源未关闭等。
Java 中 JDBC 操作报错，90% 以上不是数据库本身出问题，而是客户端配置、参数或代码逻辑没对齐。排查关键在于分清问题发生在哪一层：驱动加载层、连接建立层、SQL执行层，还是资源管理层。下面按高频场景拆解，直接对应错误现象和解决动作。
ClassNotFoundException 或 No suitable driver found
这是最典型的“找不到驱动”报错，本质是 JVM 没加载到 MySQL（或其他数据库）的 JDBC 驱动类。
- 检查 jar 包是否已添加到 classpath：Maven 项目确认
pom.xml中有正确依赖，如 MySQL 8.x 对应mysql-connector-j8.0.33+；非 Maven 项目确认mysql-connector-j-8.4.0.jar已放入lib目录并被 IDE 正确识别 - 驱动类名必须匹配：MySQL 5.x 用
com.mysql.jdbc.Driver，MySQL 8.x 必须用com.mysql.cj.jdbc.Driver；写错一个字母或漏掉cj都会失败 - 新版 JDBC（8.0.23+）可省略
Class.forName()，但若显式调用，类名必须准确；若保留该行，建议加 try-catch 并打印日志，避免静默失败
CommunicationsException: Connection refused / Connection timed out
这类异常说明 Java 进程根本连不上 MySQL 服务端，属于网络或服务配置问题，和 SQL 写法无关。
- 先确认 MySQL 服务正在运行：
systemctl status mysqld（Linux）或任务管理器查mysqld.exe（Windows） - 检查 URL 中 host 和 port 是否正确：本地常用
127.0.0.1:3306，远程需确认 IP 可达、端口未被防火墙拦截（telnet 192.168.1.100 3306测试） - MySQL 配置需允许远程连接：检查
my.cnf中bind-address是否为0.0.0.0或注释掉；确认用户权限支持从指定 host 登录（如CREATE USER 'user'@'%' IDENTIFIED BY 'pwd'; GRANT ALL ON *.* TO 'user'@'%';） - URL 补全必要参数：MySQL 8+ 强制要求时区，不加
serverTimezone=Asia/Shanghai会直接抛 CommunicationsException
SQLException: Lock wait timeout exceeded / Deadlock found
不是连不上，而是执行 DML（INSERT/UPDATE/DELETE）时卡住或失败，多发生在并发场景。
- 先查锁状态：
SHOW PROCESSLIST;找出长时间State为Locked或Updating的线程；再用SELECT * FROM information_schema.INNODB_TRX;查当前事务 - 定位后 kill 掉阻塞源：
KILL [Id];（谨慎操作，避免影响业务） - 代码层规避：尽量缩短事务范围，避免在事务中做耗时操作（如 HTTP 调用、文件读写）；UPDATE/DELETE 尽量走主键或唯一索引，减少锁表范围
- 批量操作改用
addBatch()+executeBatch()，比循环单条提交更高效且降低锁竞争
SQLSyntaxErrorException 或 Parameter index out of range
SQL 语句本身有问题，或 PreparedStatement 参数绑定出错。
- 拼接 SQL 时禁用字符串相加：比如
"WHERE name = '" + name + "'"不仅易错，还导致 SQL 注入；一律改用PreparedStatement占位符 - 检查问号个数与
setXXX()调用次数是否一致：下标从 1 开始，第 3 个参数写成setString(4, "xxx")就会报Parameter index out of range - 关键字冲突要加反引号：如字段名为
desc、order、group，SQL 中必须写成`desc`，否则解析失败 - 建表语句中注意引擎和字符集：MySQL 8 默认
utf8mb4，若建表时写CHARSET=utf8可能导致插入表情时报错
NullPointerException 或 Connection closed
连接对象为空或已被关闭，常因资源管理不当引发。
- Connection、Statement、ResultSet 必须显式关闭，且顺序为
rs → stmt → conn；推荐用 try-with-resources 自动释放 - 避免 connection 成员变量跨方法复用：构造函数里创建的局部 connection 不会赋值给 this.connection；若需复用，应在初始化后赋值，并确保线程安全（如配合连接池）
- 连接池场景下，
conn.close()实际是归还连接，不是销毁；但若手动 new Connection 后又调 close，后续再用就会报 closed - 事务未提交：autocommit 默认为 true，但若调过
conn.setAutoCommit(false)，就必须配对conn.commit()，否则数据不落库且连接可能卡住
Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南
