本文详解如何在 Spring Data JPA 中使用原生 SQL 正确查询 PostgreSQL jsonb 类型字段中指定键（如 classifiedId）等于某值的记录，纠正 jsonb_exists() 的误用，并提供安全、高效、可扩展的实现方案。
本文详解如何在 spring data jpa 中使用原生 sql 正确查询 postgresql `jsonb` 类型字段中指定键（如 `classifiedid`）等于某值的记录，纠正 `jsonb_exists()` 的误用，并提供安全、高效、可扩展的实现方案。
在 PostgreSQL 中操作 jsonb 字段时，一个常见误区是混淆 jsonb_exists() 与“键值匹配”语义。jsonb_exists(jsonb, text) 仅判断 JSONB 对象是否包含某个键名（key existence），而不校验其值——这正是原始代码无法查出 classifiedId = "665" 记录的根本原因。
正确做法是使用 PostgreSQL 提供的 JSONB 操作符 ->>（获取键对应的文本值，自动处理 null 和类型转换），结合标准 SQL 等值比较：
@Query(nativeQuery = true,
value = """
SELECT *
FROM _book_complex
WHERE external_ids ->> 'classifiedId' = :classifiedId
""")
Optional<BookComplexEntity> findByClassifiedId(@Param("classifiedId") String classifiedId);✅ 优势说明：
- ->> 返回 text 类型，支持直接字符串比较，语义清晰；
- 自动将 JSONB 中的数字、布尔等类型转为字符串（如 "665" 或 665 均可匹配 "665"），兼容性好；
- 支持数据库索引加速：可在 external_ids 上创建表达式索引提升性能：
CREATE INDEX idx_book_complex_classifiedid ON _book_complex ((external_ids ->> 'classifiedId'));
⚠️ 注意事项：
- 若 classifiedId 在部分记录中不存在或为 null，->> 返回 NULL，该行不会被匹配（符合预期）；
- 避免使用 = 直接比较 JSONB 值（如 external_ids @> '{"classifiedId":"665"}'），虽功能等价但性能略低，且不易利用函数索引；
- 生产环境建议添加 @Modifying + @Transactional（若为更新/删除操作），但本例为查询，无需额外注解；
- 使用 @Param 显式命名参数（如示例所示），提高可读性与维护性，避免位置参数错位风险。
综上，column ->> 'key' = ? 是查询 JSONB 键值对最简洁、高效且符合直觉的标准实践，应作为首选方案。
