Spring Boot存储RestApiResponse列表至MySQL遇Hibernate类型判定异常

这个错误的核心原因很明确：Hibernate不知道如何将自定义类RestApiResponse的列表持久化到MySQL中——默认情况下，Hibernate只支持基本类型、内置的JPA类型，或者明确配置了映射规则的自定义类型。下面给你两种最常用的解决方案，你可以根据业务需求选择：

方案1：将RestApiResponse定义为嵌入式值对象（推荐，适合需要查询响应内部字段的场景） #

这种方式是JPA规范的标准做法，把RestApiResponse作为值对象嵌入到主实体中，Hibernate会自动创建关联表来存储列表数据。

步骤1：标记RestApiResponse为嵌入式类 #

给RestApiResponse添加@Embeddable注解，表明它是一个可嵌入的价值对象：

import jakarta.persistence.Embeddable;
import java.io.Serializable;

@Embeddable
public class RestApiResponse implements Serializable {
    // 这里是你的RestApiResponse原有字段，比如：
    private int statusCode;
    private String message;
    private String data;

    // 必须添加无参构造函数（JPA要求）
    public RestApiResponse() {}

    // getter、setter方法
    public int getStatusCode() { return statusCode; }
    public void setStatusCode(int statusCode) { this.statusCode = statusCode; }
    // 其他字段的getter/setter
}

步骤2：修改主实体的字段映射 #

把SREAPITestingHistory中的response字段改为@ElementCollection映射，指定关联表信息：

// 替换原有response字段的注解
@ElementCollection
@CollectionTable(
    name = "sreapi_response_details", // 新建的关联表名，用来存储每个RestApiResponse
    joinColumns = @JoinColumn(name = "request_time") // 关联主表的主键字段
)
private List<RestApiResponse> response;

步骤3：简化仓库层代码 #

不需要自己写原生SQL插入，直接用Spring Data JPA提供的save方法即可，Hibernate会自动处理关联表的插入：

@Repository
public interface SREAPITestingRepository extends CrudRepository<SREAPITestingHistory, String> {
    // 移除原来的原生SQL方法，直接继承CrudRepository的save方法
}

调用时直接传入实体对象：

SREAPITestingHistory history = new SREAPITestingHistory();
history.setRequest_time("2024-05-20 10:00:00");
history.setReq_id("REQ123");
// 设置其他字段
history.setResponse(yourRestApiResponseList);
repository.save(history);

方案2：序列化列表为JSON字符串存储（适合不需要查询响应内部字段的场景） #

如果不需要单独查询RestApiResponse中的字段，只是想把整个列表存成一个整体，可以将序列化为JSON字符串存储到MySQL的TEXT或JSON类型字段中。

方式A：手动序列化（无需额外依赖） #

修改SREAPITestingHistory的字段和转换逻辑：

import com.fasterxml.jackson.core.JsonProcessingException;
import com.fasterxml.jackson.core.type.TypeReference;
import com.fasterxml.jackson.databind.ObjectMapper;
import jakarta.persistence.Column;
import jakarta.persistence.Lob;

// 把原来的List<RestApiResponse>改为String类型
@Lob
@Column(name="response_body")
private String responseBody;

// 对外暴露的getter/setter做转换
public List<RestApiResponse> getResponse() {
    ObjectMapper mapper = new ObjectMapper();
    try {
        return mapper.readValue(responseBody, new TypeReference<List<RestApiResponse>>(){});
    } catch (JsonProcessingException e) {
        throw new RuntimeException("解析响应JSON失败", e);
    }
}

public void setResponse(List<RestApiResponse> response) {
    ObjectMapper mapper = new ObjectMapper();
    try {
        this.responseBody = mapper.writeValueAsString(response);
    } catch (JsonProcessingException e) {
        throw new RuntimeException("序列化响应失败", e);
    }
}

方式B：使用Hibernate JSON类型（推荐，更简洁） #

引入hibernate-types依赖（需对应你的Hibernate版本），然后直接用注解指定JSON类型：

import com.vladmihalcea.hibernate.type.json.JsonType;
import org.hibernate.annotations.Type;
import jakarta.persistence.Column;

@Type(JsonType.class)
@Column(name="response_body", columnDefinition = "json")
private List<RestApiResponse> response;

这种方式不需要手动写序列化逻辑，Hibernate会自动帮你完成转换。

关键注意事项 #

• 避免在原生SQL中直接传递List<RestApiResponse>：JDBC无法识别自定义对象列表，要么传序列化后的字符串（方案2），要么用ORM的save方法（方案1）。
• 确保RestApiResponse实现Serializable接口：无论是嵌入式还是序列化场景，这都是必要的。

内容的提问来源于stack exchange，提问作者Naman Agarwal