为JDBC PreparedStatement设置参数时出现JDBC Exception报错求助

常见报错原因 #

• 参数下标使用错误：JDBC中PreparedStatement的参数下标从1开始计数，若代码中直接使用从0开始的循环变量作为下标，首次设值就会触发无效索引报错。
• JDBC驱动不支持行值表达式语法：部分低版本数据库驱动（如Oracle 11g之前的驱动、MySQL 5.5以下版本驱动）无法正确解析(col1, col2) IN ((?,?), (?,?))格式的行表达式，会错误识别占位符总数，导致后续参数设值时超出驱动识别的占位符数量范围。
• 全SQL占位符数量不匹配：仅检查当前查询片段的占位符数量不足，需确认整条SQL语句中所有?的总数，和待设置的参数列表长度完全一致，避免其他查询条件存在漏写/多写占位符的情况。

修复步骤 #

1. 检查参数设置逻辑的下标，确保参数索引从1开始，参考正确写法：

List<Long> params = Arrays.asList(123L, 235689L, 25L, 2568982L);
for (int i = 0; i < params.size(); i++) {
    // 下标要加1，对应JDBC从1开始的计数规则
    statement.setLong(i + 1, params.get(i).longValue());
}

2. 若下标逻辑无问题，将行表达式改写为等价的普通条件拼接写法，避开驱动兼容性问题：
   原查询片段：

... AND (tbl1.field1, tbl2.field2) IN ((?, ?), (?, ?)) ...

改写后：

... AND (
    (tbl1.field1 = ? AND tbl2.field2 = ?)
    OR
    (tbl1.field1 = ? AND tbl2.field2 = ?)
) ...

3. 统计整条SQL的?总数量，确认和参数列表长度完全匹配。

内容的提问来源于stack exchange，提问作者Dmitriy Ryabin