升级SpringBoot3后Hibernate @Type注解报错,求JsonBinaryType替代方案
解决SpringBoot3.0+Jakarta下Hibernate JSON类型注解报错问题
问题根源
SpringBoot3.x配套的是Hibernate 6+,迁移到Jakarta规范后,旧的@Type(type = "jsonb")用法彻底失效——Hibernate6移除了@Type注解的type参数,而且现在Hibernate本身已经内置了JSON类型支持,完全不需要依赖第三方的com.vladmihalcea.hibernate.type.json.JsonBinaryType。
替代方案
直接用Hibernate6内置注解实现JSON类型映射,步骤如下:
- 清理旧依赖:如果之前引入了vladmihalcea的
hibernate-types库,现在可以直接删除 - 修改实体类注解,两种方式任选:
方式一:通用适配(推荐)
用@JdbcTypeCode指定SQL类型,适配大多数支持JSON的数据库(包括PostgreSQL的jsonb):
import jakarta.persistence.Column; import org.hibernate.annotations.JdbcTypeCode; import org.hibernate.type.SqlTypes; // 其他实体注解省略 @Column(columnDefinition = "jsonb", nullable = false, updatable = true, name = "accounts") @JdbcTypeCode(SqlTypes.JSON) private ArrayList<Account> accounts;
方式二:针对PostgreSQL jsonb
如果只适配PostgreSQL的jsonb类型,可以直接指定对应的JDBC类型实现:
import jakarta.persistence.Column; import org.hibernate.annotations.JdbcType; import org.hibernate.type.descriptor.jdbc.JsonbJdbcType; // 其他实体注解省略 @Column(columnDefinition = "jsonb", nullable = false, updatable = true, name = "accounts") @JdbcType(JsonbJdbcType.class) private ArrayList<Account> accounts;
额外提醒
- 确保
Account类可被序列化,或者添加Jackson相关注解(比如@JsonProperty),让Hibernate能正常完成对象集合的序列化/反序列化。 - SpringBoot3.x自动配置已默认支持JSON类型处理,无需额外配置Hibernate类型映射。
内容的提问来源于stack exchange,提问作者TrollBearPig
相关产品推荐
相关产品推荐

