Oracle 19c中JSON_TRANSFORM的PASSING子句参数绑定问题

结论先行：Oracle 19c及更早版本中，JSON_TRANSFORM确实不支持PASSING子句，论坛的说法是正确的。Oracle官方文档此处可能存在版本标注疏漏——PASSING子句对JSON_TRANSFORM的支持是从Oracle 21c才正式引入的，19c版本的该函数并未集成此特性。

问题原因 #

虽然Oracle的多数SQL/JSON函数（如JSON_EXISTS、JSON_VALUE）在19c就支持PASSING子句，但JSON_TRANSFORM作为相对较新的SQL/JSON更新函数，在19c版本的实现中并未包含该功能，导致你使用时触发ORA-00907语法错误。

针对Spring Boot JPA场景的替代方案 #

如果你仍在使用Oracle 19c，可根据更新场景选择以下参数化方案：

1. 单字段/简单路径更新：使用JSON_SET替代 #

JSON_SET在19c中支持参数化绑定，适合更新单个明确路径的JSON字段：

@Modifying
@Query(value = "UPDATE your_table t " +
               "SET t.json_column = JSON_SET(t.json_column, :jsonPath, :newValue) " +
               "WHERE JSON_VALUE(t.json_column, '$.id') = :targetId",
       nativeQuery = true)
void updateSimpleJsonField(@Param("jsonPath") String jsonPath, 
                           @Param("newValue") Object newValue, 
                           @Param("targetId") Long targetId);

2. 数组内字段更新：结合JSON_TABLE做关联筛选 #

若需更新JSON数组中匹配特定ID的元素字段，可通过JSON_TABLE将数组拆分为关系型数据做条件筛选，再用JSON_TRANSFORM更新：

@Modifying
@Query(value = "UPDATE your_table t " +
               "SET t.json_column = JSON_TRANSFORM(" +
               "    t.json_column, " +
               "    SET '$.array[*].targetField' = :newValue " +
               "    WHERE '$.array[*].id' = :targetId" +
               ") " +
               "WHERE EXISTS (" +
               "    SELECT 1 FROM JSON_TABLE(" +
               "        t.json_column, " +
               "        '$.array[*]' COLUMNS id NUMBER PATH '$.id'" +
               "    ) jt WHERE jt.id = :targetId" +
               ")",
       nativeQuery = true)
void updateArrayJsonField(@Param("newValue") Object newValue, 
                          @Param("targetId") Long targetId);

注意：JSON_TRANSFORM路径中的:targetId在19c无法直接作为绑定变量，此写法通过外层JSON_TABLE确保只更新符合条件的行，路径条件中的值需与绑定参数保持一致，避免SQL注入风险。

3. 长期解决方案：升级到Oracle 21c+ #

若条件允许，升级到Oracle 21c或更高版本后，即可直接使用PASSING子句实现参数化路径查询：

@Modifying
@Query(value = "UPDATE your_table t " +
               "SET t.json_column = JSON_TRANSFORM(" +
               "    t.json_column, " +
               "    SET '$.array[*].targetField' = :newValue " +
               "    WHERE '$.array[*].id' = $id " +
               "    PASSING :targetId AS \"id\"" +
               ") " +
               "WHERE JSON_VALUE(t.json_column, '$.array[*].id' PASSING :targetId AS \"id\") = :targetId",
       nativeQuery = true)
void updateJsonWithPassing(@Param("newValue") Object newValue, 
                           @Param("targetId") Long targetId);

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