JPA原生查询PostgreSQL jsonb数组列如何正确绑定动态参数

正确实现方案 #

你遇到的问题核心是两点：1. JDBC参数占位符无法在单引号包裹的JSON字符串内解析；2. @> 运算符要求右侧参数必须是jsonb类型，字符串类型默认会被识别为varchar导致类型不匹配。

写法1：手动构造JSON数组字符串后强转jsonb #

在SQL层面拼接动态参数为符合结构的JSON字符串，再显式转成jsonb类型：

@Query(value = "SELECT * FROM table1 WHERE user_details @> ('[{\"email\": \"' || :email || '\"}]')::jsonb", nativeQuery = true)
List<YourEntity> findByUserDetailsEmail(@Param("email") String email);

注：字符串拼接是在SQL层面完成，JDBC参数会自动转义，不存在SQL注入风险。

写法2：用PostgreSQL JSON函数构造规范JSON结构（更推荐） #

使用jsonb_build_array+jsonb_build_object直接构造jsonb类型的参数，不需要手动处理JSON格式、转义等问题：

@Query(value = "SELECT * FROM table1 WHERE user_details @> jsonb_build_array(jsonb_build_object('email', :email))", nativeQuery = true)
List<YourEntity> findByUserDetailsEmail(@Param("email") String email);

该写法由PostgreSQL自动生成符合要求的jsonb数组结构，兼容性更高，不会出现手动拼JSON的格式错误。

之前尝试失败的原因说明 #

• 把占位符写在JSON字符串内部报错：单引号包裹的字符串属于SQL字面量，JDBC不会解析内部的:email/?1占位符，会把整个字符串当成固定值处理，自然触发JSON语法错误。
• 直接传拼接好的JSON字符串报错：你传入的拼接字符串是varchar类型，PostgreSQL没有默认隐式转换支持jsonb @> varchar运算，必须显式加::jsonb强转右侧参数类型。
• 用JSON函数查询无结果：大概率是构造的JSON结构不对，你存储的是JSON对象数组，所以@>右侧必须也是包含匹配对象的数组结构，如果只传了单个对象{"email": "xxx"}而没包在数组里，自然匹配不到结果。

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