PreparedStatement报错常因参数绑定、资源管理或调用方式不当。排查需三步：先看异常类型（如SQLSyntaxErrorException、SQLTimeoutException），再获取真实执行SQL（通过日志配置），最后检查典型误用（如动态表名列名不能参数化、未关闭资源等）。
PreparedStatement 报错不一定是 SQL 写错了，很多问题出在参数绑定、资源管理或调用方式上。排查要分三步走：先看异常类型，再抓真实执行语句，最后检查代码逻辑是否踩了典型坑。
看异常类名和 getMessage() 内容
别只打 e.printStackTrace()，必须显式打印：
e.getMessage() —— 显示数据库返回的原始错误，比如 “Unknown column 'user_name' in 'where clause'” 或 “You have an error in your SQL syntax”；
e.getSQLState() —— 快速判断错误类别：42000 是语法/对象不存在，23000 是约束冲突，08001 是连接失败，28000 是权限问题。
常见异常及含义：
- SQLSyntaxErrorException：SQL 本身有错——漏括号、用错保留字（如 name 当列名但没加反引号）、大小写不匹配、子句顺序错
- SQLTimeoutException：执行卡住，不是语法问题，而是查询太慢、锁表、网络延迟或连接池耗尽
- SQLException: Parameter index out of range：? 占位符数量和 setXxx() 调用次数对不上，比如 SQL 有 2 个 ?，却只调用了 setString(1, …)
- NullPointerException：传给 setXxx() 的值是 null，而字段不允许为空；或 connection 为 null 就直接 prepareStatement()
查真正执行的 SQL 是什么
PreparedStatement 对象里看到的 "SELECT * FROM user WHERE id = ?" 不是数据库运行的语句。必须拿到带参数值的完整 SQL 才能复现问题：
立即学习“Java免费学习笔记（深入）”；
- MySQL JDBC URL 加参数：
&profileSQL=true&logger=com.mysql.cj.log.StandardLogger - PostgreSQL 加：
&logLevel=2 - Spring Boot + JdbcTemplate：配置
logging.level.org.springframework.jdbc.core.JdbcTemplate=DEBUG - MyBatis：开启
logging.level.org.apache.ibatis=DEBUG，日志里会显示 [SQL] 和 [Parameters]
拿到日志里的完整 SQL 后，复制到 DBeaver、mysql 命令行或 psql 中直接运行，验证是否真能复现错误。这一步能快速区分是 Java 层问题，还是 SQL 本身不合法。
避开高频误用陷阱
很多报错不是语法问题，而是 PreparedStatement 用法违背了设计原则：
-
不能把表名、列名、排序字段当参数绑定：ps.setString(1, "email") 在
WHERE ? = ?中会被当成字符串字面量，实际执行的是WHERE 'email' = 'xxx'，永远不成立 -
executeUpdate() 别传 SQL 字符串：写成
ps.executeUpdate("UPDATE ...")会报错，正确写法是ps.executeUpdate()—— SQL 已在 prepare 阶段传入 -
多条语句不能用分号隔开：MySQL 默认禁用多语句执行，
"INSERT ...; UPDATE ..."会直接抛 SQLException，需在连接 URL 显式加&allowMultiQueries=true（不推荐） - 没关闭资源导致后续连接失败：Connection、PreparedStatement、ResultSet 忘关，几次运行后出现 “Too many connections”，要用 try-with-resources 自动释放
检查参数与数据库结构是否匹配
PreparedStatement 不校验列名、表名、函数名这些静态结构，只管参数类型转换。所以：
- 字段名拼错（如写成
user_name但实际是username），预编译可能通过，执行时报 “Unknown column” - 传 String 给 INT 类型字段，某些驱动会静默转成 0，有些则直接报类型不匹配
- 日期格式不对（如传 "2023-01-01" 字符串给 DATE 类型），应改用
ps.setDate(1, new java.sql.Date(...)) - 空值处理：字段设为 NOT NULL，却调用
ps.setNull(1, Types.VARCHAR)或直接传 null，会触发约束异常
