Java SpringBoot JPA中如何使用PostgreSQL存储List类型数据

我是Java相关技术的初学者，目前正在开发SpringBoot项目，需要存储数值列表数据，例如'XXXXX':[1,2,3,4...]格式，但当前得到的存储结果不符合预期。
我已经提供了编写的实体类代码、对应Repository类代码、项目中保存数据的实现逻辑、数据存储到数据库后的最终效果截图。
我不希望数据以当前的格式存储，因为后续需要通过connection_id查询获取time_slot_list，当前存储方式会增加程序复杂度，请问该如何解决该问题？如果我描述的信息存在歧义，可随时告知，我会及时补充修正，在此提前表示感谢。

你遇到的核心问题是关系型数据库本身不支持直接存储数组/列表类型字段，JPA默认对List类型的处理是将对象序列化后存储为二进制Blob格式，这就是你看到存储格式异常、后续查询解析困难的根本原因。
结合你的需求（后续按connection_id查询整条记录并获取完整的time_slot_list），推荐两种可直接落地的方案：

方案1：JSON字符串存储列表（实现成本最低，完全匹配当前需求） #

直接将列表序列化为标准JSON数组字符串，存入VARCHAR/TEXT类型的数据库字段，读取时再反序列化为List<Integer>类型。可以通过JPA的AttributeConverter实现自动转换，不需要手动在业务逻辑里写序列化/反序列化代码。

1. 修改实体类中timeSlotList字段的注解，指定自定义转换器：

   @Column(name = "time_slot_list", columnDefinition = "TEXT")
   @Convert(converter = IntegerListJsonConverter.class)
   private List<Integer> timeSlotList;
   

2. 编写自定义转换器，实现列表和JSON字符串的自动转换：

   import com.fasterxml.jackson.core.type.TypeReference;
   import com.fasterxml.jackson.databind.ObjectMapper;
   import javax.persistence.AttributeConverter;
   import javax.persistence.Converter;
   import java.util.Collections;
   import java.util.List;
   
   @Converter
   public class IntegerListJsonConverter implements AttributeConverter<List<Integer>, String> {
       private static final ObjectMapper OBJECT_MAPPER = new ObjectMapper();
   
       @Override
       public String convertToDatabaseColumn(List<Integer> attribute) {
           if (attribute == null || attribute.isEmpty()) {
               return "[]";
           }
           try {
               return OBJECT_MAPPER.writeValueAsString(attribute);
           } catch (Exception e) {
               throw new RuntimeException("时间槽列表序列化失败", e);
           }
       }
   
       @Override
       public List<Integer> convertToEntityAttribute(String dbData) {
           if (dbData == null || dbData.isBlank()) {
               return Collections.emptyList();
           }
           try {
               return OBJECT_MAPPER.readValue(dbData, new TypeReference<List<Integer>>() {});
           } catch (Exception e) {
               throw new RuntimeException("时间槽列表反序列化失败", e);
           }
       }
   }
   

3. 清空数据库中之前存的错误格式数据，重新插入后，time_slot_list字段就会存储为标准的[1,2,3,4]格式JSON数组。后续查询时JPA会自动把字段值转成List<Integer>类型，业务层可以直接使用，不需要额外解析。

方案2：关联表拆分存储（适合后续需要按列表内单个值做查询的场景） #

如果你后续除了按connection_id查完整列表，还需要做类似「查询包含某个时间槽的所有connection记录」的需求，就不要把列表存在单个字段里，用JPA的@ElementCollection注解自动创建关联表存储：

1. 修改实体类的timeSlotList字段注解：

   @ElementCollection
   @CollectionTable(
           name = "connection_time_slot_mapping",
           joinColumns = @JoinColumn(name = "connection_id")
   )
   @Column(name = "time_slot")
   private List<Integer> timeSlotList;
   

2. 启动项目后JPA会自动创建名为connection_time_slot_mapping的关联表，每个时间槽单独存一行，关联对应connection_id。这种方式支持对单个时间槽做查询、统计、过滤，灵活性更高，但会多一张表，插入和查询的性能略低于单字段存储。

避坑提醒 #

• 如果你使用的是PostgreSQL数据库，本身原生支持整数数组类型，只需要给字段加@Column(columnDefinition = "integer[]")，配合Hibernate对应类型转换器就能直接存原生数组，不需要额外做JSON转换。
• 不要使用JPA默认的Java序列化方式存储集合类型，这种方式存的二进制数据可读性为0，且不同JDK版本、依赖版本之间序列化协议可能不兼容，后续版本迭代很容易出现历史数据无法解析的问题。

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