1. 概述
本教程将聚焦如何解决 HibernateException: Illegal attempt to associate a collection with two open sessions 异常。
首先分析异常的根本原因，然后通过实际案例演示如何复现该问题，最重要的是提供解决方案。
2. 理解 HibernateException
简单来说，这个异常的核心问题在于：当使用 @OneToMany 映射的懒加载集合，在其原始 Hibernate 会话 之外被修改时就会触发。
Hibernate 将集合与加载它们的会话强绑定，如果在其他会话中访问或修改此类集合就会引发冲突。典型场景是使用已废弃的 update() 方法操作游离实体——Hibernate 官方早已不推荐这种做法。
理解该异常的含义，对于正确处理 Hibernate 应用中的会话边界和懒加载行为至关重要。下面通过实际案例深入解析。
3. 实战案例
首先定义 Author JPA 实体类：
@Entity
public class Author {
@Id
@GeneratedValue(strategy = GenerationType.AUTO)
private Long id;
private String name;
@OneToMany(mappedBy = "author", cascade = CascadeType.ALL)
private List<Book> books;
public Author(String name) {
this.name = name;
this.books = new ArrayList<>();
}
// 空构造器、标准getter/setter
}
每个作者包含唯一标识符和名称。@Entity 注解标记 Author 为 JPA 实体，@Id 定义主键，@OneToMany 描述作者与书籍的关联关系。
接着定义 Book 实体类：
@Entity
public class Book {
@Id
@GeneratedValue(strategy = GenerationType.AUTO)
private Long id;
private String title;
@ManyToOne
private Author author;
public Book(String title) {
this.title = title;
}
// 空构造器、标准getter/setter
}
这里 @ManyToOne 表示 Book 与 Author 是多对一关系——即一个作者可以拥有多本书籍。
现在通过测试用例复现异常：
@Test
void givenAnEntity_whenChangesSpanMultipleHibernateSessions_thenThoseChangesCanNotBeUpdated() {
assertThatThrownBy(() -> {
try (Session session1 = HibernateUtil.getSessionFactory()
.openSession();
Session session2 = HibernateUtil.getSessionFactory()
.openSession()) {
session1.beginTransaction();
Author author = new Author("Leo Tolstoy");
session1.persist(author);
session1.getTransaction()
.commit();
session2.beginTransaction();
author.getBooks()
.add(new Book("War and Peace"));
session2.update(author); // 踩坑点！
session2.getTransaction()
.commit();
}
}).isInstanceOf(HibernateException.class)
.hasMessageContaining("Illegal attempt to associate a collection with two open sessions");
}
测试中 author 实例在 session1 加载，却在 session2 中修改其书籍列表。使用 update() 导致异常，因为书籍集合仍关联原始会话 (session1)。
⚠️ 注意：问题的根源不仅是会话处理不当，更关键在于使用了废弃的 update() 方法——该方法错误假设实体是在当前会话中加载的。
4. 解决方案
最直接的解决方案是使用 merge() 替代废弃的 update()，它能安全地将游离实体（及其集合）重新关联到新会话：
@Test
void givenAnEntity_whenChangesSpanMultipleHibernateSessions_thenThoseChangesCanBeMerged() {
try (Session session1 = HibernateUtil.getSessionFactory()
.openSession();
Session session2 = HibernateUtil.getSessionFactory()
.openSession()) {
session1.beginTransaction();
Author author = // 创建作者
session1.persist(author);
session1.getTransaction()
.commit();
session2.beginTransaction();
Book newBook = // 创建新书
author.getBooks()
.add(newBook);
session2.merge(author); // 用merge替代update
session2.getTransaction()
.commit();
}
}
**简单说，merge() 方法将在 session1 中加载的游离作者重新关联到新会话 session2**。
粗暴理解：它将游离实例的状态复制到当前会话中新的托管实体上。这样新实例及其集合只关联当前会话。
如果不想用 merge()，也可以将操作保持在同一会话中：这样能避免书籍集合同时关联多个会话：
@Test
void givenAnEntity_whenChangesUseTheSameHibernateSession_thenThoseChangesCanBeUpdated() {
try (Session session1 = HibernateUtil.getSessionFactory()
.openSession()) {
session1.beginTransaction();
Author author = // 创建作者（同前）
session1.persist(author);
Book newBook = // 创建新书（同前）
author.getBooks()
.add(newBook);
session1.update(author); // 使用同一会话
session1.getTransaction()
.commit();
}
}
测试顺利通过，证明该方案能有效避免 HibernateException。
5. 总结
本文深入剖析了 HibernateException: Illegal attempt to associate a collection with two open sessions 的根本原因。通过实际案例演示了异常复现过程，并提供了清晰的解决方案：
✅ 核心方案：使用 merge() 替代废弃的 update()
✅ 替代方案：确保集合操作始终在同一会话中完成
❌ 避免踩坑：不要跨会话修改懒加载集合