解析XML文件存入数据库时Hibernate List类型映射错误如何解决

• JPA（Hibernate）无法将实体类SdnEntryDTO中List<String>类型的akaList字段映射为关系型数据库的字段类型：常规关系型数据库没有原生对应Java集合类型的存储结构，没有额外注解说明的情况下，Hibernate无法识别该字段的映射规则，因此启动构建SessionFactory时抛出映射异常。
• 额外逻辑问题：你业务代码中已经将所有别名拼接为逗号分隔的字符串，却又用Collections.singletonList包裹成只有一个元素的List存入实体，属于不必要的冗余操作，也加剧了类型映射的问题。

方案1：修改字段类型为String（最适配你现有业务逻辑，实现最简单） #

你当前业务已经将所有别名拼接为单条字符串，完全不需要用List存储，直接修改实体类对应字段即可：

1. 修改SdnEntryDTO的akaList字段定义：

// 原代码
@Column(name = "alias", length = 255)
private List<String> akaList;

// 修改后
@Column(name = "alias", length = 255)
private String akaList;

2. 同步修改该字段的getter、setter方法，以及全参构造方法的入参类型。
3. 修改Service层创建SdnEntryDTO的代码，去掉不必要的Collections.singletonList包裹：

// 原代码
SdnEntryDTO sdnEntryDTO = new SdnEntryDTO(Long.parseLong(uid),
        firstName + " " + lastName, program, sdnType, Collections.singletonList(String.join(",", akaList)));

// 修改后
SdnEntryDTO sdnEntryDTO = new SdnEntryDTO(Long.parseLong(uid),
        firstName + " " + lastName, program, sdnType, String.join(",", akaList));

4. 修复Service层重复存储的bug：你现有代码循环调用saveAll会导致全量列表重复存储N次，直接删除循环，单次调用即可：

// 原代码
for (SdnEntryDTO sdnEntryDTO : ofacs) {
    fileDTORepository.saveAll(ofacs);
}

// 修改后
fileDTORepository.saveAll(ofacs);

方案2：添加集合映射注解（适合需要单独查询别名的场景） #

如果你后续需要对别名做单独的查询、过滤操作，需要保留List类型，可以用@ElementCollection注解标注集合字段，Hibernate会自动生成中间表存储别名数据：

// 修改akaList字段定义
@ElementCollection
@CollectionTable(name = "sdn_alias", joinColumns = @JoinColumn(name = "sdn_entry_id"))
@Column(name = "alias")
private List<String> akaList;

同时修改Service层代码，直接传入解析出来的akaList即可，不需要再做逗号拼接。

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