Spring Data JPA中PostgreSQL JSONB操作符解析异常问题解析

问题背景

在Spring Data JPA项目中使用PostgreSQL的JSONB操作符时，开发人员遇到了一个特殊问题。当在原生SQL查询中使用?|操作符（JSONB的"存在任意键"操作符）时，Spring Data JPA错误地将其识别为参数绑定标记，导致查询无法正常执行。

问题表现

具体表现为以下查询语句会抛出异常：

select '["x", "c"]'::jsonb ?| array[:approvalStatus]::text[]

错误信息显示：

Mixing of ? parameters and other forms like ?1 is not supported

技术分析

这个问题本质上是一个SQL解析器的误判。Spring Data JPA的查询解析器在预处理SQL语句时，会将?字符识别为参数绑定标记的起始符号。而PostgreSQL的JSONB操作符?|恰好以?开头，导致解析器错误地认为这是一个参数绑定标记。

解决方案

Spring Data团队已经修复了这个问题。修复方案主要涉及改进SQL查询解析器的逻辑，使其能够正确识别PostgreSQL特有的操作符模式。具体来说：

1. 解析器现在能够区分真正的参数绑定标记和PostgreSQL操作符
2. 对于?|这样的操作符，不再错误地触发参数绑定解析

版本影响

该问题影响以下版本：

• Spring Boot 3.4.3
• Spring Boot 3.5.0

修复后的版本：

• 3.4.4-SNAPSHOT
• 3.5.1-SNAPSHOT

开发者建议

对于遇到类似问题的开发者，建议：

1. 及时升级到包含修复的版本
2. 在使用PostgreSQL特有操作符时，注意观察是否有类似解析问题
3. 如果暂时无法升级，可以考虑使用函数替代操作符，如jsonb_exists_any()替代?|

总结

这个问题展示了ORM框架在处理特定数据库语法时可能遇到的挑战。Spring Data JPA团队通过改进解析器逻辑，增强了对PostgreSQL特有语法的支持能力，为开发者提供了更好的使用体验。这也提醒我们在使用ORM框架时，要注意框架对特定数据库特性的支持程度。