升级Spring后Spring Data JPA+Hibernate执行save&flush时主键冲突

核心问题定位 #

你的问题根源是Hibernate版本与JPA API版本不匹配导致的主键生成逻辑紊乱，而非Spring Data JPA直接的兼容性问题。Spring 5.3.20对应的spring-data-jpa 2.6.5，默认适配Hibernate 5.6.x系列，而你依赖的hibernate-jpa-2.1-api是JPA 2.1规范，Hibernate 5.6.x已适配JPA 2.2，版本错位直接打乱了序列生成逻辑。

分步解决方法 #

1. 统一JPA与Hibernate依赖版本 #

• 移除hibernate-jpa-2.1-api的显式依赖，Spring Data JPA和Hibernate核心包会自动引入对应版本的JPA API，避免版本冲突。
• 直接引入hibernate-core 5.6.x版本（如5.6.14.Final），确保和spring-data-jpa 2.6.x的版本匹配。

2. 修正实体类主键注解配置 #

改SEQUENCE策略后问题恶化，大概率是注解配置不完整，按以下格式调整：

@Id
@GeneratedValue(strategy = GenerationType.SEQUENCE, generator = "entity_seq")
@SequenceGenerator(
    name = "entity_seq",
    sequenceName = "ORACLE_DB_SEQUENCE_NAME", // 对应Oracle库中实际的序列名
    allocationSize = 1 // 必须和Oracle序列的INCREMENT BY值一致
)
private Long id;

• 重点：allocationSize必须和Oracle序列的增量值匹配，默认Hibernate会用50的分配大小，若你的序列增量是1却未显式指定，会导致Hibernate缓存的序列值和数据库实际值脱节。
• 彻底放弃AUTO策略，Oracle环境下AUTO会优先使用表生成器而非序列，这就是你之前拿到已用键值的原因。

3. 配置Hibernate强制使用新生成器 #

在配置文件中添加以下参数，禁用旧版主键生成兼容逻辑：

# application.properties
spring.jpa.hibernate.use-new-id-generator-mappings=true
spring.jpa.properties.hibernate.id.new_generator_mappings=true

4. 同步Oracle序列与表主键最大值 #

检查序列当前值是否小于表中已存在的最大主键：

-- 查询序列当前值
SELECT YOUR_SEQUENCE_NAME.CURRVAL FROM DUAL;
-- 查询表中最大主键
SELECT MAX(id) FROM YOUR_TABLE;

若序列值偏小，手动更新序列到表最大ID+1：

-- 计算需要增量的步长
ALTER SEQUENCE YOUR_SEQUENCE_NAME INCREMENT BY (SELECT MAX(id)+1 - YOUR_SEQUENCE_NAME.CURRVAL FROM YOUR_TABLE);
-- 触发一次序列增长，同步到目标值
SELECT YOUR_SEQUENCE_NAME.NEXTVAL FROM DUAL;
-- 恢复序列原增量值
ALTER SEQUENCE YOUR_SEQUENCE_NAME INCREMENT BY 1;

额外注意事项 #

• 不要随意切换主键类型（long→Long），这无法解决序列问题，反而可能引入不必要的装箱拆箱问题，保持Long类型即可（Hibernate推荐使用包装类型）。
• 升级后清理项目依赖缓存（如Maven执行clean install -U，Gradle执行clean build --refresh-dependencies），确保依赖为匹配的最新版本。

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