PreparedStatement参数类型不匹配异常在执行时抛出，排查需三步：一查数据库字段实际类型（如DESCRIBE或information_schema），二核对setXXX()方法与列类型的语义匹配（如DATE列禁用setString），三用setObject(..., JDBCType.XXX)显式声明类型并开启驱动日志验证绑定值。
Java 中 PreparedStatement 参数类型不匹配异常（如 SQLException 提示“数据类型不匹配”“不能将 X 转换为 Y”）通常不会在编译期暴露，而是在执行时（executeQuery() 或 executeUpdate()）抛出。排查关键在于：**明确 SQL 预期类型、检查 setXXX() 方法调用与数据库列定义的一致性，并借助日志和工具缩小范围。**
确认数据库表字段的实际类型
这是最常被忽略的起点。不要依赖 ORM 映射或印象，直接查数据库元信息：
- MySQL：执行
DESCRIBE table_name或SHOW COLUMNS FROM table_name - PostgreSQL：查询
SELECT column_name, data_type FROM information_schema.columns WHERE table_name = 'xxx' - Oracle：查
USER_TAB_COLUMNS视图 - 注意区分
VARCHAR2(50)和CHAR(50)、TIMESTAMP和DATE、NUMBER(10,2)和NUMBER(10)等细微差异
核对 setXXX() 方法与字段类型的语义匹配
PreparedStatement 的 setXXX() 方法不是“按值自动适配”，而是按 JDBC 类型语义绑定。常见错配：
- 对
DATE列用了setString("2024-01-01")→ 应改用setDate(new java.sql.Date(...))或setObject(1, LocalDate.now(), JDBCType.DATE) - 对
BOOLEAN（PostgreSQL/MySQL 8.0+）列用了setInt(1)→ 应用setBoolean(true)；旧版 MySQL 常用TINYINT(1)，此时setInt(1)合理，但setBoolean(true)也可能被驱动接受（取决于驱动版本） - 对
DECIMAL列传入double（精度丢失风险）→ 优先用BigDecimal+setBigDecimal() - 对
JSON字段（如 MySQL 5.7+、PostgreSQL）用了setString()→ 多数驱动支持，但需确保字符串是合法 JSON；某些场景需显式setObject(..., JDBCType.VARCHAR)或驱动特定类型
开启 JDBC 驱动日志，观察实际绑定行为
很多驱动支持打印预编译参数（非 SQL 本身），能直观看到“传了什么、转成什么”：
Alibabacloud Sdk Client Initialization For Java
下载
在 Java 中初始化和管理阿里云 SDK客户端。包括单例模式、线程安全、endpoint 与 region 配置、VPC 终端节点、同步与异步等。
立即学习“Java免费学习笔记（深入）”；
- MySQL Connector/J：添加连接参数
?logger=com.mysql.cj.log.StandardLogger&profileSQL=true，或设置 JVM 参数-Dcom.mysql.cj.logger=StandardLogger - PostgreSQL JDBC：启用
loggerLevel=DEBUG和loggerFile=pgjdbc.log - HikariCP 用户可在配置中加
data-source-properties: loggerLevel=DEBUG（视驱动支持） - 日志中会显示类似
Parameters: [123, 'abc', 2024-01-01]，注意看值是否符合预期，特别是时间、null、空字符串等边界情况
用 setObject() + JDBCType 显式声明类型（推荐新写法）
JDBC 4.2+ 支持 setObject(int parameterIndex, Object x, JDBCType targetSqlType)，让类型意图更明确，减少驱动猜测：
ps.setObject(1, "abc", JDBCType.VARCHAR);ps.setObject(2, LocalDate.now(), JDBCType.DATE);ps.setObject(3, BigDecimal.valueOf(123.45), JDBCType.DECIMAL);- 相比传统
setString()/setDate()，它更贴近 SQL 标准，且部分驱动对setObject(..., JDBCType.XXX)的类型校验更严格——反而能在早期暴露不匹配问题
不复杂但容易忽略：异常堆栈里往往包含具体字段名或参数位置（如 “Parameter #2”），结合 SQL 和 set 调用顺序逐行比对，再对照数据库字段类型，基本就能定位。
