JPA+H2树形结构实体持久化：升级H2版本引发主键冲突问题

我有一个树形结构的实体类，在H2 Database Engine v1.4.200版本下实体持久化完全正常，但升级到最新版v2.1.214后，抛出了主键约束违反异常。从异常信息来看，似乎parent和root关联对象也会随当前实体一起被持久化（异常详情见下文）。想请教从v1.4.200到v2.1.214，H2的哪些变更可能导致这个问题？

实体类代码（Node.java） #

import java.util.ArrayList;
import java.util.List;

import javax.persistence.Entity;
import javax.persistence.FetchType;
import javax.persistence.GeneratedValue;
import javax.persistence.GenerationType;
import javax.persistence.Id;
import javax.persistence.JoinColumn;
import javax.persistence.ManyToOne;
import javax.persistence.Transient;

@Entity
public class Node {

    @Id
    @GeneratedValue(strategy = GenerationType.IDENTITY)
    private Long id;

    private String name;
    
    @ManyToOne(fetch = FetchType.EAGER)
    @JoinColumn(name = "parent_id")
    @JsonIgnore
    private Node parent;
    
    @ManyToOne(fetch = FetchType.EAGER)
    @JoinColumn(name = "root_id")
    @JsonIgnore
    public Node root;

    @Transient
    public List<Node> children = new ArrayList<>();
}

控制器代码（NodeController.java） #

import org.springframework.http.HttpStatus;
import org.springframework.http.ResponseEntity;
import org.springframework.web.bind.annotation.PostMapping;
import org.springframework.web.bind.annotation.RequestBody;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RestController;

@RestController
@RequestMapping(value = "/api/node")
public class NodeController {

    private NodeService nodeService;

    public NodeController(NodeService nodeService) {
        this.nodeService = nodeService;
    }

    @PostMapping("/save")
    public ResponseEntity<?> create(@RequestBody Node node) {
        Node entity = nodeService.save(node);
        return new ResponseEntity<>(entity, HttpStatus.CREATED);
    }

}

异常信息 #

o.h.engine.jdbc.spi.SqlExceptionHelper:
    Unique index or primary key violation: "PRIMARY KEY ON PUBLIC.NODE(ID) ( /* key:1 */ CAST(1 AS BIGINT), 'Node 1', NULL, NULL)"; SQL statement:
    insert into node (id, name, parent_id, root_id) values (default, ?, ?, ?) [23505-214]

.m.m.a.ExceptionHandlerExceptionResolver:
    Resolved [org.springframework.dao.DataIntegrityViolationException: could not execute statement; SQL [n/a]; constraint ["PRIMARY KEY ON PUBLIC.NODE(ID) ( /* key:1 */ CAST(1 AS BIGINT), 'Node 1', NULL, NULL)"; SQL statement:<EOL>insert into node (id, name, parent_id, root_id) values (default, ?, ?, ?) [23505-214]]; nested exception is org.hibernate.exception.ConstraintViolationException: could not execute statement]

可能导致问题的H2版本变更点 #

• IDENTITY生成策略行为调整
  H2 v2.0+对IDENTITY自增列的处理逻辑更严格：旧版本中，即使实体携带了ID值，使用default插入时H2会自动生成新ID；但v2.0+下，如果传入的实体（或其关联的parent/root）带有已存在的ID值，Hibernate可能误将其当作有效主键，导致插入时触发重复键冲突。

• 关联实体持久化判定逻辑变化
  H2 v2优化了JDBC元数据和事务处理逻辑，可能影响Hibernate对关联实体状态的判断：旧版本中，Hibernate会将已存在的detached状态关联实体仅作为外键引用；但v2.0+下，可能误判为transient状态，尝试重复插入关联实体，进而触发主键冲突。

• EAGER加载与事务边界交互变更
  你的parent和root都使用FetchType.EAGER，H2 v2对事务内实体加载的逻辑有调整，可能导致保存主实体时，关联的EAGER实体被强制持久化。如果这些关联实体本身带有已存在的ID值，就会引发主键冲突。

• 默认兼容性模式变更
  H2 v2.0+默认不再兼容旧版本的非标准JDBC行为，若未显式设置兼容性模式（如MODE=LEGACY），Hibernate的持久化逻辑会因JDBC规范的严格执行而出现异常。

排查与解决建议 #

1. 检查前端传入的Node对象及其关联的parent/root是否携带非空ID值，若是，保存前需清空这些关联实体的ID，或先从数据库查询获取managed状态的实体引用。
2. 在H2连接URL中添加MODE=LEGACY参数，切换到旧版本兼容模式，验证是否为兼容性问题导致。
3. 确认Hibernate版本与H2 v2.1.214兼容，建议升级到Hibernate ORM 5.6+或6.x版本。
4. 考虑将GenerationType.IDENTITY替换为GenerationType.SEQUENCE或TABLE，避开H2对IDENTITY的新处理逻辑。

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