如何通过JSONB列中的值查询PostgreSQL行（Spring Data JPA）

方案一：使用数组展开+存在性查询（推荐） #

这种方式避开JSON构造的转义坑，通过展开数组后直接匹配字段，逻辑更直观：

1. 仓库接口方法定义：

@Query(nativeQuery = true, value = """
    SELECT * FROM item
    WHERE EXISTS (
        SELECT 1 FROM jsonb_array_elements(item_stats -> 'barcodes') AS elem
        WHERE elem ->> 'code' = ?1
    )
""")
ItemEntity findByBarcode(String barcode);

2. 逻辑说明：

• jsonb_array_elements(item_stats -> 'barcodes') 将barcodes数组展开为独立的行记录
• elem ->> 'code' 提取数组元素中code字段的字符串值，直接与传入的参数对比
• 调用时只需传入原始code字符串，无需处理任何JSON转义

方案二：修正@>包含操作符的用法 #

如果要继续使用PostgreSQL的JSON包含操作符@>，需确保构造的JSON格式完全正确：

方式A：提前构造完整JSON参数 #

1. 仓库方法定义：

@Query(nativeQuery = true, value = "SELECT * FROM item WHERE item_stats -> 'barcodes' @> CAST(:jsonBarcode AS jsonb)")
ItemEntity findByBarcode(@Param("jsonBarcode") String jsonBarcode);

2. 调用时构造合法JSON字符串（推荐用Jackson保证格式正确性）：

// 手动构造示例
String jsonBarcode = String.format("[{\"code\": \"%s\"}]", barcode);

// 更安全的ObjectMapper构造方式
ObjectMapper mapper = new ObjectMapper();
Map<String, String> codeMap = new HashMap<>();
codeMap.put("code", barcode);
String jsonBarcode = mapper.writeValueAsString(List.of(codeMap));

ItemEntity item = itemRepo.findByBarcode(jsonBarcode);

方式B：在查询中用SpEL拼接JSON #

利用Spring EL表达式直接在查询语句中生成合法JSON，避免转义错误：

@Query(nativeQuery = true, value = """
    SELECT * FROM item 
    WHERE item_stats -> 'barcodes' @> '[{\"code\": ''#{#barcode}''}]'::jsonb
""")
ItemEntity findByBarcode(@Param("barcode") String barcode);

说明：SQL中用两个单引号''转义单引号，确保最终生成的JSON里code值是带双引号的字符串格式。

原问题报错原因 #

你之前的查询失败是因为：

• 硬编码的JSON字符串转义处理错误，导致生成的JSON包含无效反斜杠
• 参数替换后，code的值未被包裹在双引号中，不符合JSON字符串类型的语法要求（比如最终生成[{"code": 3123123123}]，而实际存储的是字符串类型的code值）

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