Quarkus JPA项目出现detached entity passed to persist异常原因求解

基础背景 #

JPA规范中实体分为4种状态：

• 临时态（Transient）：刚创建的实例，没有主键值，也未被持久化上下文管理
• 持久态（Managed）：有主键值，被当前活跃的EntityManager管理
• 游离态（Detached）：有主键值，但未被当前活跃的EntityManager管理
• 删除态（Removed）：已标记待删除，尚未执行数据库删除操作

EntityManager的persist方法仅支持传入临时态的实体，如果传入已有主键的游离态实体，就会触发你遇到的detached entity passed to persist异常。

写法1报错的原因 #

1. 你定义的ENTITY是静态常量，整个测试类运行期间只会初始化一次，所有测试用例共用同一个对象实例。
2. Quarkus测试默认给每个测试方法开启独立事务，方法执行完成后自动回滚事务：
   • 第一个测试调用persist时，实体被纳入持久化上下文管理，插入数据库的同时，JPA会按照主键生成策略给这个静态实体对象的id字段赋值
   • 事务回滚只会撤销数据库的插入操作，不会重置JVM中这个静态实体对象已经被赋值的id属性
3. 第一个测试跑完后，当前持久化上下文销毁，这个已有id的实体就进入游离态。
4. 第二个测试再把同一个实体传给persist方法时，EntityManager检测到它不是无主键的临时态实体，直接抛出异常。

写法2正常运行的原因 #

每个测试方法都调用entity()新建独立的实体实例，每个实例都是刚创建的临时态，没有id值，完全符合persist方法的入参要求，因此不会触发异常。

额外优化建议 #

如果确实需要复用实体构造逻辑，除了每次新建实例外，也可以选择两种方案：

• 每次调用persist前手动把实体的id置为初始值（你的id是基础类型long，初始值为0）
• 将Repository的persist逻辑改为兼容游离态的entityManager.merge(entity)，注意merge的语义和persist有区别：merge会返回新的持久态实例，原有传入的实例仍为游离态。

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