使用NamedParameterJdbcTemplate调用含CLOB参数存储过程失败

错误原因拆解 #

1. ArrayIndexOutOfBoundsException
   该错误出现在Oracle驱动的字符编码转换环节：你用字节流给CLOB参数赋值，但CLOB是字符大对象，驱动会尝试将字节直接按字符规则转换。当字节数达到32768时，驱动内部的字符转换数组长度刚好为32768，索引超出边界触发异常——本质是字节流与CLOB的字符类型不匹配导致的编码转换错误。

2. IllegalArgumentException（类型不支持）
   省略length参数时，SqlLobValue无法识别字节数组类型，因为CLOB对应的是字符类型（字节类型对应BLOB），因此抛出"Content type [[B] not supported for CLOB columns]"异常。

正确处理方式 #

CLOB是字符大对象，必须用字符流/字符串传递参数，而非字节流。以下两种方案任选：

方案1：使用字符流（推荐大文件场景） #

直接将输入流转为Reader（指定正确编码，比如UTF-8，匹配Oracle的AL32UTF8编码），用字符流构造SqlLobValue：

public void addDocuments(InputStream data, String name) throws IOException, SQLException {
    // 按实际编码调整，此处假设输入流为UTF-8编码
    Reader clobReader = new InputStreamReader(data, StandardCharsets.UTF_8);
    
    SqlParameterSource paramSource = new MapSqlParameterSource()
            .addValue("cblob", new SqlLobValue(clobReader, new DefaultLobHandler()), OracleTypes.CLOB);

    final List<SomeResponse> query = this.template.query(ADD_DOCUMENTS, paramSource, new SomeResponseMapper(true));
}

方案2：使用字符串（小文件场景） #

如果数据量不大，可先将字节数组转为字符串，直接传递字符串参数（Spring JDBC会自动处理为CLOB类型）：

public void addDocuments(InputStream data, String name) throws IOException, SQLException {
    byte[] byteArray = IOUtils.toByteArray(data);
    // 同样指定正确编码
    String clobContent = new String(byteArray, StandardCharsets.UTF_8);
    
    SqlParameterSource paramSource = new MapSqlParameterSource()
            .addValue("cblob", clobContent, OracleTypes.CLOB);

    final List<SomeResponse> query = this.template.query(ADD_DOCUMENTS, paramSource, new SomeResponseMapper(true));
}

额外建议 #

• 检查Oracle驱动版本，老版本ojdbc可能存在大CLOB处理的bug，建议升级到ojdbc8或更高版本。
• 确认输入流的编码与数据库字符集（AL32UTF8）一致，避免乱码或转换错误。

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