Hibernate含额外字段的多对多关联更新报错，求排查原因

错误根源1：集合未初始化导致clear()抛出异常 #

你的TransactionEntity类中tags字段没有初始化，Hibernate加载实体时，如果关联集合为空，会返回不可修改的空集合（比如Collections.emptyList()），此时调用clear()就会触发UnsupportedOperationException。

解决方法：
在TransactionEntity中初始化tags为可变列表：

@OneToMany(mappedBy = "transaction", cascade = CascadeType.ALL, orphanRemoval = true, fetch = FetchType.LAZY)
private List<TransactionTagEntity> tags = new ArrayList<>();

错误根源2：关联实体的嵌入式主键未正确初始化 #

TransactionTagEntity的嵌入式主键pk是必须字段，但你在buildTransactionTagEntity中创建实例时，没有初始化这个主键。Hibernate无法识别未设置的主键，会导致持久化逻辑异常（虽然直接触发的是集合异常，但这是潜在的致命问题）。

解决方法：
修改TransactionTagEntity的构造函数，确保初始化嵌入式主键：

// 替换原有的@AllArgsConstructor，或自定义构造函数
public TransactionTagEntity(TransactionEntity transaction, TagEntity tag) {
    this.transaction = transaction;
    this.tag = tag;
    // 初始化主键
    this.pk = new TransactionTagPk(transaction.getTransactionId(), tag.getTagId());
}

同时注意：如果保留@AllArgsConstructor，要确保构造函数参数包含pk，且创建实例时传入正确的主键对象。

错误根源3：Stream.toList()返回不可变列表（Java 16+） #

Java 16及以上版本中，Stream.toList()返回的是不可修改的列表。当你调用setTags(transactionTagEntityList)后，Hibernate后续尝试修改这个列表（比如级联操作）时，会抛出UnsupportedOperationException。

解决方法：
改用Collectors.toList()生成可变列表：

import java.util.stream.Collectors;

// ...

List<TransactionTagEntity> transactionTagEntityList = tagsId.stream()
    .map(tagId -> buildTransactionTagEntity(transactionEntity.get(), tagId))
    .collect(Collectors.toList());

额外注意点 #

• 确保TransactionTagPk实现了正确的equals()和hashCode()方法（你用了@Data，已经自动生成，没问题）。
• 检查TransactionTagEntity中的@JoinColumn设置insertable=false, updatable=false是正确的，因为主键由@MapsId维护，不需要Hibernate额外处理这些字段的插入更新。

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