JDBC PreparedStatement调用json_exists查询JSON的参数设置问题

我之前在处理Oracle JSON查询转JDBC PreparedStatement时也踩过完全一样的坑！invalid column index这个错误的根源在于，直接在json_exists的路径表达式里用?占位符，JDBC驱动根本不会把它识别成PreparedStatement的参数——它会把这个?当成JSON路径语法的一部分，导致你设置参数时，驱动认为没有可绑定的参数，自然就报索引错误了。

正确的参数绑定方式：使用passing子句 #

Oracle的json_exists支持通过**passing子句**传递绑定变量，这是官方推荐的安全绑定方式，也能完美适配JDBC PreparedStatement。

单参数示例

假设你原本的SQL是这样的（错误写法）：

-- 错误：路径里的?不会被JDBC识别为参数
SELECT * FROM orders WHERE json_exists(order_data, '$.items[*]?(@.product_id = ?)')

改成带passing子句的正确写法：

SELECT * FROM orders 
WHERE json_exists(order_data, '$.items[*]?(@.product_id = :prod_id)' passing ? as "prod_id")

对应的JDBC代码：

String sql = "SELECT * FROM orders WHERE json_exists(order_data, '$.items[*]?(@.product_id = :prod_id)' passing ? as \"prod_id\")";
PreparedStatement pstmt = conn.prepareStatement(sql);
// 只需要设置第1个参数，对应passing里的?
pstmt.setString(1, "PROD123");
ResultSet rs = pstmt.executeQuery();

// 处理结果集逻辑
while (rs.next()) {
    // ...
}

多参数示例

如果需要匹配多个JSON字段，比如同时校验产品ID和价格：

SELECT * FROM orders 
WHERE json_exists(order_data, '$.items[*]?(@.product_id = :prod_id && @.price > :min_price)' 
passing ? as "prod_id", ? as "min_price")

对应的JDBC代码：

String sql = "SELECT * FROM orders WHERE json_exists(order_data, '$.items[*]?(@.product_id = :prod_id && @.price > :min_price)' passing ? as \"prod_id\", ? as \"min_price\")";
PreparedStatement pstmt = conn.prepareStatement(sql);
pstmt.setString(1, "PROD123");
pstmt.setBigDecimal(2, new BigDecimal("50.00"));
ResultSet rs = pstmt.executeQuery();

关键注意事项 #

• 路径变量与passing别名一致：路径里的:prod_id必须和passing ? as "prod_id"里的别名完全匹配，建议用双引号包裹别名避免大小写问题。
• Oracle版本要求：passing子句从Oracle 12c Release 2（12.2）开始支持，确保你的数据库版本符合要求。
• 避免直接在路径里写?：永远不要在JSON路径表达式里直接用?作为占位符，JDBC驱动无法解析这种写法，必然导致参数索引错误。

内容的提问来源于stack exchange，提问作者attempts-to-code