如何将已存在的Tag实体合并到持久化上下文？为何合并后仍报错？

你的代码里有两个核心问题导致错误无法解决：

1. 判断逻辑完全失效
   manager.contains(tag) 仅当Tag实体已存在于当前持久化上下文时才返回true，但前端传过来的Tag是JSON反序列化生成的全新对象，根本不在上下文里，所以这个判断永远不会触发merge操作，等于白写。

2. merge后的对象未替换原集合中的对象
   就算触发了merge，manager.merge(tag)会返回一个托管状态的新对象，但你没有把原Task的tags集合里的detached对象替换成这个托管对象，Task里还是原来的detached Tag，保存时依然会触发cascade persist操作，导致报错。

另外，你的Task实体用@OneToMany + @JoinTable模拟多对多关系，虽然可行，但cascade配置是MERGE,PERSIST，当保存Task时，Hibernate会对集合里的所有Tag执行persist操作——带id的detached Tag执行persist就会抛出detached entity passed to persist错误。

方案1：修正Service层逻辑，正确处理detached Tag #

修改saveNewTask方法，根据Tag是否有id区分已存在的Tag和新Tag，替换集合中的对象为托管状态：

@PersistenceContext 
private EntityManager manager;

public Task saveNewTask(Task taskToSave) {
    Set<Tag> managedTags = new HashSet<>();
    for (Tag tag : taskToSave.getTags()) {
        if (tag.getId() != null) {
            // 已存在的Tag：从数据库获取托管对象（若不需要更新Tag内容，推荐用find而非merge）
            Tag managedTag = manager.find(Tag.class, tag.getId());
            managedTags.add(managedTag);
        } else {
            // 新Tag：直接加入，后续cascade persist会自动处理
            managedTags.add(tag);
        }
    }
    // 替换原集合为托管对象集合
    taskToSave.setTags(managedTags);
    return repository.save(taskToSave);
}

方案2：改用@ManyToMany映射（更贴合业务场景） #

既然数据库是多对多关系，即使不需要反向关联，也可以用@ManyToMany简化配置，同时调整cascade策略：

修改Task实体的tags字段：

@ManyToMany(cascade = {CascadeType.MERGE, CascadeType.PERSIST})
@JoinTable(
        name = "join_table",
        joinColumns = @JoinColumn(name = "task_id"),
        inverseJoinColumns = @JoinColumn(name = "tag_id"))
private Set<Tag> tags;

然后Service层逻辑可以简化为：

public Task saveNewTask(Task taskToSave) {
    Set<Tag> updatedTags = new HashSet<>();
    for (Tag tag : taskToSave.getTags()) {
        if (tag.getId() != null) {
            // 合并detached Tag为托管状态
            Tag managedTag = manager.merge(tag);
            updatedTags.add(managedTag);
        } else {
            updatedTags.add(tag);
        }
    }
    taskToSave.setTags(updatedTags);
    return repository.save(taskToSave);
}

额外提示 #

• 若不需要更新已存在Tag的内容，优先用manager.find()而非merge，避免意外修改数据库中已有的Tag数据。
• 建议给Tag的text字段添加唯一约束，防止重复创建相同名称的Tag。

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