设置PreparedStatement参数时出现参数序号越界异常求助

问题背景 #

使用以下Arrow Flight SQL JDBC依赖：

<dependency>
   <groupId>org.apache.arrow</groupId>
   <artifactId>flight-sql-jdbc-driver</artifactId>
   <version>13.0.0</version>
</dependency>

编写的Java测试代码：

public static void handleSqlStatements() throws SQLException {
    String url = "jdbc:arrow-flight://localhost:5000;useEncryption=false;";
    var connection = DriverManager.getConnection(url);
    String sql = "select * from SometypeDB.`Table` where OID = ?"; 
    System.out.println("SQL query: " + sql); 
    try (Connection conn = DriverManager.getConnection(url);
         PreparedStatement statement = conn.prepareStatement(sql)) {
        int parameterIndex = 1; 
        long value = 123L;

        System.out.println("Setting parameter at index " + parameterIndex + " to value " + value);
        statement.setLong(parameterIndex, value);
        System.out.println("Executing SQL query: " + sql);

        try (ResultSet rs = statement.executeQuery()) {
            
        }// Process ResultSet
    } catch (SQLException e) {
        e.printStackTrace(); // Ensure detailed error output is available
    }
}

运行时抛出参数越界异常：

SQL query: select * from SometypeDB.`Table` where OID = ?
Setting parameter at index 1 to value 123
java.sql.SQLException: parameter ordinal 1 out of range
    at cfjd.org.apache.calcite.avatica.Helper.createException(Helper.java:60)
    at cfjd.org.apache.calcite.avatica.AvaticaPreparedStatement.getParameter(AvaticaPreparedStatement.java:427)
    at cfjd.org.apache.calcite.avatica.AvaticaPreparedStatement.getSite(AvaticaPreparedStatement.java:434)
    at cfjd.org.apache.calcite.avatica.AvaticaPreparedStatement.setLong(AvaticaPreparedStatement.java:178)

异常来自AvaticaPreparedStatement的以下代码片段：

protected AvaticaParameter getParameter(int param) throws SQLException {
        try {
            return (AvaticaParameter)this.getSignature().parameters.get(param - 1);
        } catch (IndexOutOfBoundsException var3) {
            throw AvaticaConnection.HELPER.toSQLException(AvaticaConnection.HELPER.createException("parameter ordinal " + param + " out of range"));
        }
    }

原因分析 #

从异常栈和代码片段可以看出，this.getSignature().parameters是空列表或长度为0，调用get(param-1)时触发IndexOutOfBoundsException，进而转为SQL异常。核心原因是驱动未正确识别SQL中的参数占位符?，或服务端返回的PreparedStatement元数据未包含参数信息，具体诱因可能包括：

• 13.0.0版本的Arrow Flight SQL JDBC驱动存在参数解析bug，对带反引号的表名处理异常，无法识别后续的参数占位符。
• 服务端的Flight SQL实现未正确处理PreparedStatement的参数元数据返回，导致驱动端无法获取参数列表。
• SQL语句中的反引号标识符（Table）干扰了驱动的参数解析逻辑。

解决方案 #

针对上述可能的原因，可按以下步骤排查解决：

1. 调整SQL语句格式，避免反引号干扰 #

尝试移除表名的反引号，或替换为双引号（需符合服务端SQL语法规范），修改后的SQL示例：

select * from SometypeDB.Table where OID = ?

或

select * from SometypeDB."Table" where OID = ?

重新运行代码，验证参数占位符是否被正确识别。

2. 升级Arrow Flight SQL JDBC驱动版本 #

13.0.0是较早版本，后续版本修复了多个参数解析相关bug。建议升级到最新稳定版（如15.0.0或更高），修改依赖：

<dependency>
   <groupId>org.apache.arrow</groupId>
   <artifactId>flight-sql-jdbc-driver</artifactId>
   <version>15.0.0</version>
</dependency>

3. 验证服务端Flight SQL实现的兼容性 #

确认服务端的Flight SQL服务（如Arrow Flight SQL Server或其他兼容实现）是否正确支持PreparedStatement的参数元数据返回。可通过服务端日志或调试工具，检查驱动发送Prepare请求后，服务端是否返回了包含参数信息的响应。

4. 临时替代方案：使用Statement（仅测试场景） #

如果只是临时测试，可绕过PreparedStatement直接拼接SQL语句（生产环境禁止此做法，存在SQL注入风险）：

String sql = String.format("select * from SometypeDB.`Table` where OID = %d", 123L);
try (Statement stmt = conn.createStatement();
     ResultSet rs = stmt.executeQuery(sql)) {
    // 处理结果集
}

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