如何通过Spring JPA + Hibernate在MySQL中存储JSON对象数组？

1. 调整Skill类 #

Skill无需作为独立数据库实体，移除@Entity注解，将其改为普通值对象POJO：

import java.io.Serializable;

public class Skill implements Serializable {
    private String name;
    private String category;

    // 无参构造器、全参构造器
    // Getter、Setter方法
}

（实现Serializable是为了让序列化/反序列化过程更稳定，可选但推荐）

2. 方案一：自定义JPA属性转换器 #

创建转换器负责List<Skill>与JSON字符串的双向转换：

import jakarta.persistence.AttributeConverter;
import jakarta.persistence.Converter;
import com.fasterxml.jackson.core.JsonProcessingException;
import com.fasterxml.jackson.databind.ObjectMapper;
import java.util.List;

@Converter(autoApply = false)
public class SkillListConverter implements AttributeConverter<List<Skill>, String> {
    private final ObjectMapper objectMapper = new ObjectMapper();

    @Override
    public String convertToDatabaseColumn(List<Skill> skills) {
        try {
            return objectMapper.writeValueAsString(skills);
        } catch (JsonProcessingException e) {
            throw new RuntimeException("技能列表转JSON失败", e);
        }
    }

    @Override
    public List<Skill> convertToEntityAttribute(String dbData) {
        if (dbData == null || dbData.isEmpty()) {
            return List.of();
        }
        try {
            return objectMapper.readValue(
                dbData,
                objectMapper.getTypeFactory().constructCollectionType(List.class, Skill.class)
            );
        } catch (JsonProcessingException e) {
            throw new RuntimeException("JSON转技能列表失败", e);
        }
    }
}

在Employee类的skills字段上绑定该转换器：

import jakarta.persistence.Entity;
import jakarta.persistence.Id;
import jakarta.persistence.Column;
import jakarta.persistence.Convert;
import java.util.ArrayList;
import java.util.List;

@Entity
public class Employee {
    @Id
    private int id;

    @Column(columnDefinition = "JSON")
    @Convert(converter = SkillListConverter.class)
    private List<Skill> skills = new ArrayList<>();

    // Getter、Setter方法
}

3. 方案二：使用Hibernate原生JsonType（推荐） #

若项目使用Hibernate 5.2+，可直接借助JsonType简化操作，无需自定义转换器：
首先添加对应版本的依赖（Spring Boot 3+示例）：

<!-- Maven -->
<dependency>
    <groupId>com.vladmihalcea</groupId>
    <artifactId>hibernate-types-60</artifactId>
    <version>2.21.1</version>
</dependency>

// Gradle
implementation 'com.vladmihalcea:hibernate-types-60:2.21.1'

修改Employee类：

import jakarta.persistence.Entity;
import jakarta.persistence.Id;
import jakarta.persistence.Column;
import org.hibernate.annotations.Type;
import java.util.ArrayList;
import java.util.List;

@Entity
public class Employee {
    @Id
    private int id;

    @Column(columnDefinition = "JSON")
    @Type(com.vladmihalcea.hibernate.type.json.JsonType.class)
    private List<Skill> skills = new ArrayList<>();

    // Getter、Setter方法
}

注意事项 #

• MySQL版本需5.7及以上，才支持原生JSON字段类型
• 确保Skill类的所有字段都有对应的Getter/Setter，保证Jackson能正确序列化/反序列化
• 自定义转换器需处理空值场景，避免空指针异常

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