关于Hypersistence-utils JsonBinaryType的预期用途及PostgreSQL jsonb字段更新时类型转换错误的求助

我完全理解你现在遇到的这个PostgreSQL jsonb字段更新的类型匹配问题有多闹心——明明用了Hypersistence-utils的JsonBinaryType来处理JSON类型，结果不管传List数组还是字符串参数，都被PostgreSQL报类型不匹配的错误，一会儿是bytea，一会儿是varchar，确实让人摸不着头脑。结合你用的Hibernate 6.6和Hypersistence-utils 3.10.1版本，我来给你拆解问题原因和解决办法：

问题根源分析 #

你遇到的两个错误本质上是同一个问题：Hibernate/Hypersistence-utils传递的参数类型和PostgreSQL的jsonb字段预期类型不匹配：

• 当你传入List<String>时，通用的JsonBinaryType会将对象序列化为二进制字节流（bytea类型），但PostgreSQL的jsonb字段并不接受这种二进制格式，因此报错；
• 当你传入字符串时，Hibernate直接将其识别为普通的varchar类型，PostgreSQL无法自动将varchar隐式转换为jsonb，因此同样报错。

解决方案 #

针对你的场景，有两个直接可行的解决办法，你可以根据自己的需求选择：

方案1：使用PostgreSQL专属的PostgreSqlJsonBinaryType #

Hypersistence-utils专门为PostgreSQL的jsonb类型提供了PostgreSqlJsonBinaryType，它会自动适配PostgreSQL的jsonb类型要求，将Java对象序列化为JSON字符串并告知JDBC驱动这是jsonb类型，完美避开类型不匹配问题。

代码示例：

EntityManager em; // 已获取的EntityManager实例
List<String> strings = List.of("foo", "bar");

Query q = em.createNativeQuery("update foo_entity set jsonb_column = :value");
q.setParameter("value", new TypedParameterValue<>(
    new PostgreSqlJsonBinaryType(new ObjectMapper()), 
    strings
));
q.executeUpdate();

方案2：原生SQL中显式CAST参数为jsonb #

如果你更倾向于使用通用的JsonBinaryType，可以在原生更新SQL中显式将参数转换为jsonb类型，强制PostgreSQL识别参数格式：

代码示例：

EntityManager em; // 已获取的EntityManager实例
List<String> strings = List.of("foo", "bar");

Query q = em.createNativeQuery("update foo_entity set jsonb_column = CAST(:value AS jsonb)");
q.setParameter("value", new TypedParameterValue<>(
    new JsonBinaryType(new ObjectMapper()), 
    strings
));
q.executeUpdate();

额外注意事项 #

为了确保整个流程顺畅，还需要检查你的Hibernate方言配置：
请确保在项目配置中使用支持jsonb的PostgreSQL高版本方言，比如：

# application.properties 示例配置
spring.jpa.properties.hibernate.dialect=org.hibernate.dialect.PostgreSQL15Dialect

高版本的PostgreSQL方言对jsonb类型的支持更完善，能更好地和Hypersistence-utils的类型处理器配合工作。

验证方法 #

更新完成后，你可以执行一个简单的查询来验证结果是否正确：

List<Object> result = em.createNativeQuery("select jsonb_column from foo_entity").getResultList();
result.forEach(System.out::println);

正常情况下，你会看到输出的是["foo","bar"]这样的JSON数组格式。

内容来源于stack exchange