java.sql.SQLException：参数索引越界(3>2)问题排查求助

这个问题我之前踩过好几次坑，核对参数范围还出问题的话，大概率是你忽略了一些「隐形」的占位符或者SQL拼接细节，给你列几个最常见的原因：

• SQL中的占位符被误包含在字符串/常量里
  比如你写的SQL是这样的：

  INSERT INTO orders(user_id, order_desc) VALUES(?, '订单编号?')
  

  这里第二个?是字符串常量的一部分，JDBC不会把它当成参数占位符，实际有效占位符只有1个，但如果你的代码里设置了2个参数，就会触发类似的索引越界错误。对应你的情况，可能是你以为有3个占位符，但其中一个其实在字符串里，实际只有2个。

• 动态拼接SQL时的分支逻辑错误
  很多时候我们会用StringBuilder或者条件判断来动态生成SQL，比如：

  StringBuilder sql = new StringBuilder("SELECT * FROM users WHERE id = ? AND name = ?");
  // 假设某个条件不满足，没添加第三个占位符
  if (false) {
      sql.append(" AND age > ?");
  }
  // 但代码里还是习惯性设置了第三个参数
  PreparedStatement ps = conn.prepareStatement(sql.toString());
  ps.setInt(1, 101);
  ps.setString(2, "Alice");
  ps.setInt(3, 18); // 这里就会报错！
  

  这种情况很容易被忽略——你以为逻辑分支会添加第三个占位符，但实际因为条件不满足，SQL里只有2个?，但参数却设置了3个。

• 复制粘贴后的同步错误
  比如你一开始写的SQL有3个占位符，后来修改SQL删掉了一个，但代码里的参数设置没同步更新，还是保留了3个参数的设置，这种「改了SQL忘改参数」的低级错误其实很常见。

• 注释里的占位符干扰（少见但可能）
  有些老版本的JDBC驱动可能会误把注释里的?当成占位符，比如：

  SELECT * FROM users WHERE id = ? -- 后续要加?过滤状态
  

  如果驱动错误识别了注释里的?，会导致占位符数量统计出错，进而引发参数索引不匹配的问题。

快速排查方法 #

最直接的方式是把最终生成的SQL字符串打印出来，数一下里面真正有效的占位符数量（排除字符串、注释里的?），再和代码里设置参数的数量一一对比，很快就能找到不匹配的地方。

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