JPA CriteriaBuilder调用Oracle json_value报ORA-40454问题求助

核心问题根因 #

标准JPA API中CriteriaBuilder.literal()生成的表达式，默认会被持久层实现（如Hibernate）识别为可安全绑定的参数值，最终编译为预编译SQL的?占位符。但Oracle数据库的json_value函数强制要求JSON路径参数必须是直接书写在SQL文本中的硬字面量，不接受绑定变量传值，因此触发ORA-40454: path expression not a literal报错。

以下方案全程不绑定特定持久层框架的专有API，完全基于JPA标准规范实现： #

方案1：使用Jakarta Persistence 3.2+ 标准内联字面量API #

从JPA规范正式迭代到Jakarta Persistence 3.2版本开始，CriteriaBuilder新增了标准化的inline()方法，专门用于生成需要直接内联到SQL文本中的字面量，从规范层面明确要求所有合规的持久层实现不得将该方法生成的参数转为绑定占位符。

仅需对原有代码做一行修改：

// 原写法：会被转为绑定占位符
// Expression jsonPath = cb.literal("$.type");
// 标准内联写法：直接渲染为SQL文本中的字面量
Expression jsonPath = cb.inline("$.type");
Expression exp = cb.function("json_value", String.class, r.get("json_text"), jsonPath);
query.orderBy(exp);

该方式完全基于公共标准API，无论底层是Hibernate、EclipseLink还是其他合规JPA实现，都可以正确生成目标SQL：
SELECT * FROM foo foo0_ order by json_value(foo0_.json_text, '$.type') #

方案2：低版本JPA的兼容实现（无框架硬绑定） #

如果项目暂未升级到Jakarta Persistence 3.2以上版本，不需要引入Hibernate专属的内部LiteralExpression类，只需实现一个轻量的、符合javax.persistence.criteria.Expression接口的内联字面量包装类，即可实现无绑定的字面量渲染：

• 包装类仅依赖JPA标准接口，不引入任何持久层框架的类路径依赖
• 类内部持有项目中硬编码的固定JSON路径常量，在SQL生成阶段会被直接渲染为文本字面量，不会生成绑定占位符
• 切换持久层实现时无需调整任何业务代码，仅需根据对应实现的扩展点做适配即可

关键注意事项 #

• SQL注入防控：所有需要内联到SQL中的字符串必须是代码中硬编码的固定常量，绝对不能将外部传入的动态参数作为内联字面量，避免注入风险
• 效果验证：开启持久层的SQL生成日志，确认最终排序子句中json_value的第二个参数是直接书写的字符串字面量，不存在?占位符，即为生效
• 兼容性规避：避免直接使用Hibernate内部API，这类类不属于公开规范，会随Hibernate大版本迭代调整结构，极易在升级时出现类加载异常

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