You need to enable JavaScript to run this app.
优惠活动
大模型
产品
解决方案
定价
更多

升级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类型映射,步骤如下:

  1. 清理旧依赖:如果之前引入了vladmihalcea的hibernate-types库,现在可以直接删除
  2. 修改实体类注解,两种方式任选:

方式一:通用适配(推荐)

用@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

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.08.06 05:35:36