多实例Spring Boot应用Javers全局ID主键重复约束异常解决

配置问题诊断 #

1. 依赖版本风险：当前使用的javers-spring-boot-starter-sql:7.0.0-RC3是候选发布版本，这类版本通常存在未修复的多实例并发场景bug，是引发主键冲突的潜在诱因。
2. 多实例序列不同步：PostgreSQL中Javers核心表（jv_global_id、jv_commit）依赖自增序列生成主键，当多个应用实例共用同一Schema时，若序列未在全局层面同步，不同实例可能生成重复主键值，触发唯一约束冲突。
3. 临时拆分Schema的局限性：为新模块单独创建schema_b仅规避了跨模块序列冲突，但原有模块的序列可能因之前的异常已出现值落后于表中现有主键最大值的情况，后续插入仍会触发重复键问题。

最优解决方案 #

1. 升级Javers至稳定版本 #

替换候选版本为正式稳定版，推荐使用7.0.0或更高正式版，修复多实例场景下的序列同步问题：

implementation "org.javers:javers-spring-boot-starter-sql:7.0.0"

2. 修复已损坏的数据库序列 #

针对已出现冲突的序列，执行SQL将其值重置为对应表中现有主键的最大值+1，避免后续插入重复：

修复jv_global_id序列

SELECT setval('schema_a.jv_global_id_seq', (SELECT MAX(global_id_pk) + 1 FROM schema_a.jv_global_id));

修复jv_commit序列

SELECT setval('schema_a.jv_commit_seq', (SELECT MAX(commit_pk) + 1 FROM schema_a.jv_commit));

注意：执行前需暂停对应表的写入操作，避免数据不一致。

3. 多实例共用Schema的最佳配置 #

确保所有共享同一数据库的Javers实例满足以下要求：

• 所有实例的javers.sqlSchema配置为同一Schema（如schema_a），禁止跨Schema混用同一Javers数据集。
• 验证Javers自动创建的序列为PostgreSQL全局序列，确保插入操作通过nextval('schema_a.jv_global_id_seq')等方式获取主键，而非硬编码值（可临时开启logging.level.org.javers.repository.sql=DEBUG查看SQL日志）。

4. 长期预防措施 #

• 所有应用实例使用相同版本的Javers依赖，避免版本差异导致的表结构、序列逻辑不一致。
• 生产环境部署前，在预发环境模拟多实例并发写入场景，验证Javers主键生成逻辑稳定性。
• 跨模块审计需求优先选择统一Schema，而非拆分Schema，降低维护复杂度。

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