H2数据库ID置null保存时不自增 与PostgreSQL行为不一致

这个问题是两个逻辑不匹配共同导致的：

• 直接修改JPA托管状态实体的主键违反JPA规范。从数据库查询出的实体默认处于持久化上下文托管状态，直接在原对象上执行setId(null)会被Hibernate识别为「篡改已托管实体的主键值」，直接抛出identifier of an instance of X was altered from 1 to null错误。PostgreSQL环境未触发该错误属于特定版本下的兼容偶现，不是标准合法行为。
• 测试环境H2数据库未开启PostgreSQL兼容模式时，自增主键（IDENTITY策略）的生成逻辑和PostgreSQL不一致：对于曾分配过ID值的对象，即使ID被置为null，H2也不会自动触发自增ID生成，最终导致保存后实体ID为null。
• Controller层Mock逻辑和该错误无直接关联。

按优先级从高到低选择：

• 优先采用新建实体拷贝属性的方式实现复制存新行逻辑，这是符合JPA规范的通用写法，不会受数据库类型、JPA版本影响。
  示例代码：

  // 从数据库查询原有持久化实体
  SourceEntity oldEntity = entityRepository.findById(sourceId).orElseThrow();
  // 新建全新的瞬态实体
  SourceEntity newEntity = new SourceEntity();
  // 拷贝除ID外的所有业务属性，避免直接修改原托管实体
  BeanUtils.copyProperties(oldEntity, newEntity, "id");
  // 按需修改新实体的业务字段
  newEntity.setBizField(updatedValue);
  // 保存新实体，会正常触发数据库自增ID生成
  entityRepository.save(newEntity);
  

• 给测试环境H2数据库开启PostgreSQL兼容模式，对齐生产环境数据库行为。
  测试配置文件（application-test.yml）参考配置：

  spring:
    datasource:
      url: jdbc:h2:mem:test;MODE=PostgreSQL;DATABASE_TO_LOWER=TRUE;DB_CLOSE_DELAY=-1
      driver-class-name: org.h2.Driver
      username: sa
      password:
    jpa:
      hibernate:
        ddl-auto: create-drop
      properties:
        hibernate:
          dialect: org.hibernate.dialect.H2Dialect
  

• 如果要复用原有实体对象，必须先将其从持久化上下文中分离，解除托管状态后再修改ID。
  示例代码：

  SourceEntity oldEntity = entityRepository.findById(sourceId).orElseThrow();
  // 将实体从持久化上下文分离，转为游离态
  entityManager.detach(oldEntity);
  // 此时修改ID不会触发主键篡改校验
  oldEntity.setId(null);
  oldEntity.setBizField(updatedValue);
  entityRepository.save(oldEntity);
  

不要依赖「直接修改托管实体ID置空后保存」的写法，该行为在不同数据库方言、不同Hibernate版本下表现不一致，即使生产环境PostgreSQL暂时运行正常，后续版本升级也可能触发隐式bug。

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