Spring Boot 3迁移：Hibernate 6无法将PostgreSQL bytea转为String[]

问题根源 #

你之前的尝试失败是因为：

• @JdbcTypeCode(SqlTypes.ARRAY) 是映射SQL标准的ARRAY类型，而你的数据库字段是bytea（二进制存储），两者类型不匹配，导致JDBC值提取异常。
• 改用Object[]时，Hibernate 6的类型处理逻辑发生变化，CollectionJavaType无法转换为BasicPluralJavaType，触发类型转换错误。
• 传统的SerializationUtils已废弃，直接用ObjectInputStream存在反序列化安全风险，不可取。

可行方案 #

方案1：使用JSON序列化（推荐，安全通用） #

将String[]序列化为JSON格式的二进制数据存储到bytea，读取时反序列化为String[]。该方式无安全风险，兼容性好，无需依赖Java序列化。

步骤1：实现JPA属性转换器

import com.fasterxml.jackson.core.JsonProcessingException;
import com.fasterxml.jackson.databind.ObjectMapper;
import jakarta.persistence.AttributeConverter;
import jakarta.persistence.Converter;
import java.io.IOException;

@Converter(autoApply = false)
public class StringArrayToByteaConverter implements AttributeConverter<String[], byte[]> {

    private final ObjectMapper objectMapper = new ObjectMapper();

    @Override
    public byte[] convertToDatabaseColumn(String[] attribute) {
        if (attribute == null) {
            return null;
        }
        try {
            return objectMapper.writeValueAsBytes(attribute);
        } catch (JsonProcessingException e) {
            throw new RuntimeException("序列化String[]到JSON失败", e);
        }
    }

    @Override
    public String[] convertToEntityAttribute(byte[] dbData) {
        if (dbData == null) {
            return null;
        }
        try {
            return objectMapper.readValue(dbData, String[].class);
        } catch (IOException e) {
            throw new RuntimeException("从JSON反序列化为String[]失败", e);
        }
    }
}

步骤2：在实体字段上应用转换器

@Column(name = "dummy", columnDefinition = "bytea")
@Convert(converter = StringArrayToByteaConverter.class)
private String[] dummy;

方案2：兼容旧Java序列化数据（带安全过滤） #

如果数据库中已存在用Java序列化存储的bytea数据，需要兼容时，可使用Spring提供的序列化工具，并通过类白名单限制反序列化范围，解决安全问题。

步骤1：实现兼容型转换器

import org.springframework.core.serializer.DefaultDeserializer;
import org.springframework.core.serializer.DefaultSerializer;
import org.springframework.core.serializer.support.DeserializingConverter;
import org.springframework.core.serializer.support.SerializingConverter;
import jakarta.persistence.AttributeConverter;
import jakarta.persistence.Converter;

@Converter(autoApply = false)
public class LegacyStringArrayToByteaConverter implements AttributeConverter<String[], byte[]> {

    private final SerializingConverter serializer = new SerializingConverter();
    private final DeserializingConverter deserializer;

    public LegacyStringArrayToByteaConverter() {
        DefaultDeserializer defaultDeserializer = new DefaultDeserializer();
        // 仅允许反序列化String数组和String类，限制安全风险
        defaultDeserializer.setAllowedClasses(String[].class, String.class);
        this.deserializer = new DeserializingConverter(defaultDeserializer);
    }

    @Override
    public byte[] convertToDatabaseColumn(String[] attribute) {
        if (attribute == null) {
            return null;
        }
        return (byte[]) serializer.convert(attribute);
    }

    @Override
    public String[] convertToEntityAttribute(byte[] dbData) {
        if (dbData == null) {
            return null;
        }
        return (String[]) deserializer.convert(dbData);
    }
}

步骤2：在实体字段上应用该转换器

@Column(name = "dummy", columnDefinition = "bytea")
@Convert(converter = LegacyStringArrayToByteaConverter.class)
private String[] dummy;

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