Hibernate @Type注解类型解析失败，无法持久化Set<String>至PostgreSQL

针对Spring Boot 3 + Hibernate 6场景下，将Set<String>持久化到PostgreSQL的bytea列的问题，以下是可行方案：

问题原因 #

使用@JdbcTypeCode(Types.VARBINARY)时，Hibernate默认采用ArrayList的序列化逻辑，而你的属性是HashSet，导致类型转换异常。Hibernate 6已弃用旧版@Type注解的部分用法，需适配新的类型系统。

方案一：自定义JavaType适配Set #

通过实现Hibernate的JavaType接口，专门处理Set<String>的序列化与反序列化，配合@JdbcTypeCode和@JavaType注解使用。

1. 编写自定义序列化器 #

import org.hibernate.type.descriptor.WrapperOptions;
import org.hibernate.type.descriptor.java.JavaType;
import org.hibernate.type.descriptor.java.MutableMutabilityPlan;
import org.hibernate.type.descriptor.jdbc.JdbcType;
import org.hibernate.type.descriptor.jdbc.VarbinaryJdbcType;
import org.hibernate.type.spi.TypeConfiguration;

import java.io.*;
import java.util.HashSet;
import java.util.Set;

public class SetStringBinarySerializer implements JavaType<Set<String>> {

    @Override
    public MutabilityPlan<Set<String>> getMutabilityPlan() {
        return new MutableMutabilityPlan<>() {
            @Override
            protected Set<String> deepCopyNotNull(Set<String> value) {
                return new HashSet<>(value);
            }
        };
    }

    @Override
    public JdbcType getRecommendedJdbcType(TypeConfiguration typeConfiguration) {
        return new VarbinaryJdbcType();
    }

    @Override
    public <X> X unwrap(Set<String> value, Class<X> type, WrapperOptions options) {
        if (value == null) {
            return null;
        }
        try (ByteArrayOutputStream bos = new ByteArrayOutputStream();
             ObjectOutputStream oos = new ObjectOutputStream(bos)) {
            oos.writeObject(value);
            oos.flush();
            return (X) bos.toByteArray();
        } catch (IOException e) {
            throw new RuntimeException("序列化Set<String>失败", e);
        }
    }

    @Override
    public <X> Set<String> wrap(X value, WrapperOptions options) {
        if (value == null) {
            return null;
        }
        byte[] bytes = (byte[]) value;
        try (ByteArrayInputStream bis = new ByteArrayInputStream(bytes);
             ObjectInputStream ois = new ObjectInputStream(bis)) {
            return (Set<String>) ois.readObject();
        } catch (IOException | ClassNotFoundException e) {
            throw new RuntimeException("反序列化Set<String>失败", e);
        }
    }
}

2. 实体类属性配置 #

import jakarta.persistence.Column;
import jakarta.persistence.Entity;
import jakarta.persistence.Id;
import org.hibernate.annotations.JdbcTypeCode;
import org.hibernate.annotations.JavaType;
import java.sql.Types;
import java.util.Set;

@Entity
public class YourEntity {

    @Id
    private Long id;

    @Column(name = "errors", columnDefinition = "bytea")
    @JdbcTypeCode(Types.VARBINARY)
    @JavaType(SetStringBinarySerializer.class)
    private Set<String> errors;

    // 构造方法、Getter、Setter省略
}

方案二：注册全局自定义BasicType #

如果需要多个实体复用该类型，可以将其注册为全局BasicType，通过TypeContributor加载。

1. 定义BasicType #

import org.hibernate.type.BasicType;
import org.hibernate.type.descriptor.jdbc.VarbinaryJdbcType;

public class SetStringBinaryType implements BasicType<Set<String>> {

    public static final SetStringBinaryType INSTANCE = new SetStringBinaryType();

    @Override
    public String getName() {
        return "set-string-binary";
    }

    @Override
    public Set<String> getDefaultValue() {
        return null;
    }

    @Override
    public JavaType<Set<String>> getJavaTypeDescriptor() {
        return new SetStringBinarySerializer();
    }

    @Override
    public JdbcType getJdbcTypeDescriptor() {
        return VarbinaryJdbcType.INSTANCE;
    }
}

2. 编写TypeContributor #

import org.hibernate.boot.model.TypeContributions;
import org.hibernate.boot.model.TypeContributor;
import org.hibernate.service.ServiceRegistry;

public class CustomTypeContributor implements TypeContributor {
    @Override
    public void contribute(TypeContributions typeContributions, ServiceRegistry serviceRegistry) {
        typeContributions.contributeType(SetStringBinaryType.INSTANCE);
    }
}

3. 配置加载TypeContributor #

在application.properties中添加：

spring.jpa.properties.hibernate.type_contributors=com.yourpackage.CustomTypeContributor

4. 实体类中使用 #

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

@Entity
public class YourEntity {

    @Id
    private Long id;

    @Column(name = "errors", columnDefinition = "bytea")
    @Type(SetStringBinaryType.class)
    private Set<String> errors;

    // 构造方法、Getter、Setter省略
}

注意事项 #

• 序列化方式依赖Java对象序列化，若后续修改Set的实现类（如改用LinkedHashSet），反序列化时可能出现兼容性问题，建议固定使用HashSet。
• bytea存储的是二进制数据，无法直接在数据库中查询字符串内容，若有查询需求需提前评估是否接受该限制。
• Hibernate 6中@Type注解需导入org.hibernate.annotations.Type，而非旧版JPA的注解。

内容的提问来源于stack exchange，提问作者Shanmuga Priya S