IntelliJ Spring Boot Maven项目启动报java.util.Set类型识别错误如何解决

错误核心原因 #

报错的根本原因是JPA实体类映射规则错误，Hibernate 无法将 Account 实体中类型为 java.util.Set 的 account_transactions 字段映射为数据库可识别的存储类型，最终导致会话工厂创建失败、项目启动终止。

核心报错信息翻译：

org.springframework.beans.factory.BeanCreationException：创建类路径资源[org/springframework/boot/autoconfigure/orm/jpa/HibernateJpaConfiguration.class]中定义的名为'entityManagerFactory'的Bean失败：init方法调用失败；嵌套异常为javax.persistence.PersistenceException：[PersistenceUnit: default] 无法构建Hibernate SessionFactory；嵌套异常为org.hibernate.MappingException：无法识别account表中[org.hibernate.mapping.Column(account_transactions)]列的类型java.util.Set

解决方案 #

场景1：account_transactions 是关联其他表的一对多/多对多字段 #

这是绝大多数遇到该报错的场景，你需要给该字段添加正确的JPA关联注解，不能直接当做普通字段处理：

// 以账户与交易记录的一对多关联为例
import javax.persistence.OneToMany;
import java.util.Set;

// Account实体类
@Entity
@Table(name = "account")
public class Account {
    // 其他字段省略...
    
    // mappedBy填写Transaction实体类中对应关联Account的字段名
    @OneToMany(mappedBy = "account", cascade = CascadeType.ALL, fetch = FetchType.LAZY)
    private Set<Transaction> accountTransactions;
    
    // getter、setter省略
}

如果是多对多关联，替换为@ManyToMany注解并配置关联表即可。

场景2：需要将Set直接序列化存入单个字段 #

如果该字段不需要关联其他表，只是要把Set集合序列化后存储到表的单个字段中，需要添加自定义类型转换器：

1. 先自定义转换器：

import javax.persistence.AttributeConverter;
import javax.persistence.Converter;
import com.fasterxml.jackson.core.type.TypeReference;
import com.fasterxml.jackson.databind.ObjectMapper;
import java.util.Set;

@Converter
public class SetToStringConverter implements AttributeConverter<Set<String>, String> {
    private final ObjectMapper objectMapper = new ObjectMapper();

    @Override
    public String convertToDatabaseColumn(Set<String> attribute) {
        try {
            return objectMapper.writeValueAsString(attribute);
        } catch (Exception e) {
            return null;
        }
    }

    @Override
    public Set<String> convertToEntityAttribute(String dbData) {
        try {
            return objectMapper.readValue(dbData, new TypeReference<Set<String>>() {});
        } catch (Exception e) {
            return null;
        }
    }
}

2. 给字段添加转换器注解：

@Convert(converter = SetToStringConverter.class)
private Set<String> accountTransactions;

常见踩坑排查 #

• 不要给关联字段加@Column注解，关联字段由JPA自动管理映射规则，手动加@Column会导致映射冲突
• 检查实体类的访问策略，如果注解加在字段上就不要在getter方法上重复加注解，避免访问策略不匹配
• Set要指定明确的泛型类型，不要使用无泛型的裸Set类型

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