Spring Data JDBC如何在数据库层查询校验jsonb类型列值

PostgreSQL 原生提供了jsonb类型的专属操作符，你不需要修改已有的序列化/反序列化转换器，直接在Repository层写原生SQL就能在数据库侧完成JSON字段的过滤校验，常用写法如下：

1. 使用->>操作符取字段值匹配（最直观） #

->>是PostgreSQL中取JSON字段文本值的操作符，直接在@Query注解中写原生SQL即可：

import org.springframework.data.jdbc.repository.query.Query;
import org.springframework.data.repository.CrudRepository;
import java.util.List;

public interface DemoRepository extends CrudRepository<DemoEntity, Long> {
    // 固定查询active为true的记录
    @Query("SELECT * FROM demo_table WHERE state ->> 'active' = 'true'")
    List<DemoEntity> listAllActive();

    // 支持参数化查询，动态传入要匹配的状态
    @Query("SELECT * FROM demo_table WHERE state ->> 'active' = :isActive")
    List<DemoEntity> listByActiveStatus(Boolean isActive);
}

如果要避免字符串和布尔值的隐式转换问题，可以用->取jsonb原生值后强转类型再比对，写法更严谨：

SELECT * FROM demo_table WHERE (state -> 'active')::boolean = true

2. 使用@>包含操作符匹配（性能更优） #

如果需要匹配JSON中的键值对，推荐用@>包含操作符，只要给state列创建GIN索引，查询性能会远高于逐字段取值的写法：

// 按包含关系匹配JSON键值对
@Query("SELECT * FROM demo_table WHERE state @> :condition::jsonb")
List<DemoEntity> listByStateCondition(String condition);

调用时直接传入JSON格式的匹配条件字符串即可，比如要查active为true的记录，传参"{\"active\": true}"就行。如果是固定条件，也可以直接在SQL中写死：

SELECT * FROM demo_table WHERE state @> '{"active": true}'::jsonb

3. 注意事项 #

• Spring Data JDBC的@Query注解默认执行原生SQL，不要用JPQL语法写JSON相关查询，直接用PostgreSQL原生支持的JSONB函数、操作符即可
• 高频查询场景建议给jsonb列创建GIN索引提升查询速度，建索引语句：

CREATE INDEX idx_demo_table_state ON demo_table USING GIN (state);

• 你之前配置的@WritingConverter、@ReadingConverter只负责Java实体和PGobject之间的类型转换，不会影响数据库侧的JSON字段查询逻辑，不需要调整现有转换器代码

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