Spring Boot+JPA+MySQL项目JSONObject字段Hibernate映射异常问询

你遇到的这个错误很典型——Hibernate（JPA的默认实现）并没有内置org.json.JSONObject类型的数据库映射规则，所以它不知道该怎么把这个对象转换成数据库能存储的格式。下面给你两种可行的解决方案：

方案一：自定义AttributeConverter（推荐） #

我们可以通过JPA的@Convert注解，写一个转换器来实现JSONObject和数据库字符串（或JSON类型）之间的互相转换。

步骤1：编写转换器类 #

创建一个实现AttributeConverter<JSONObject, String>的类：

import org.json.JSONObject;
import javax.persistence.AttributeConverter;
import javax.persistence.Converter;

@Converter(autoApply = true) // autoApply=true会自动应用到所有JSONObject类型的字段
public class JSONObjectConverter implements AttributeConverter<JSONObject, String> {

    @Override
    public String convertToDatabaseColumn(JSONObject jsonObject) {
        return jsonObject != null ? jsonObject.toString() : null;
    }

    @Override
    public JSONObject convertToEntityAttribute(String dbData) {
        return dbData != null ? new JSONObject(dbData) : null;
    }
}

步骤2：修改Book实体类 #

在people字段上添加@Convert注解（如果设置了autoApply=true，这一步可以省略），同时建议把数据库字段类型指定为JSON（MySQL 5.7及以上支持）：

@Entity
public class Book {
    @Id
    @Column(name="bookName")
    private String bookName;
    @Column(name="author")
    private String author;
    @Column(name="copiesTotal")
    private int copiesTotal;
    @Column(name="copiesAvailable")
    private int copiesAvailable;
    @Column(name="people", columnDefinition = "JSON") // 指定数据库字段为JSON类型
    @Convert(converter = JSONObjectConverter.class) // 关联转换器
    private JSONObject people;
    
    // 构造方法、setter和getter省略
}

方案二：改用Map<String, String>类型（更符合JPA习惯） #

如果你不想依赖org.json.JSONObject，可以直接把people字段改成Map<String, String>，Hibernate会自动把它映射成JSON格式（需要数据库支持JSON类型）：

@Entity
public class Book {
    // 其他字段省略
    
    @Column(name="people", columnDefinition = "JSON")
    private Map<String, String> people;
    
    // 构造方法、setter和getter修改为对应Map类型
}

这种方式更符合JPA的使用习惯，而且不需要额外写转换器，Spring Data JPA会自动处理序列化和反序列化。

注意事项 #

• 确保你的MySQL版本是5.7或以上，这样才能支持原生的JSON字段类型；如果是旧版本，可以把columnDefinition改成TEXT，同样能存储JSON字符串。
• 如果使用方案一，记得把org.json的依赖正确引入到你的项目中（比如Maven或Gradle）。

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