升级Spring与Hibernate后测试出现主键ConstraintViolationException问题

从你的描述来看，这个问题完全符合我之前帮团队排查过的Spring+Hibernate版本升级后测试环境主键冲突的场景——核心问题出在TABLE类型主键生成器在新版本里的锁机制、事务处理逻辑变化，再加上构建服务器测试的特殊运行方式（比如并行）放大了这个问题。下面是具体的分析和解决思路：

1. Hibernate 5.x对TableGenerator的实现调整 #

Hibernate 4.x到5.x之间，TableGenerator的内部逻辑有不少关键修复：

• 4.x里可能存在“锁粒度不够”的情况，比如多个线程可以同时读取同一序列行并分配相同的批次；而5.x收紧了锁机制，但如果测试环境的事务配置不匹配（比如非事务性操作），反而会导致锁释放不及时，触发重复主键。
• 5.x对allocationSize的处理更严格，如果测试用例的事务回滚后，Hibernate不会自动归还已分配的序列批次，而构建服务器的并行测试会让多个测试线程争抢同一批次。

2. Spring 5.x测试事务的行为变化 #

Spring Test在5.x版本对事务回滚的处理更精细化：

• 如果测试用例没有正确标记@Transactional，或者自定义了事务传播属性，会导致序列表的修改没有被回滚，下一个测试拿到的序列值可能和之前的测试重叠。
• 构建服务器大概率开启了并行测试（比如Maven Surefire的parallel配置），而本地测试是串行的，所以本地不会触发并发争抢序列的问题。

方案1：显式配置TableGenerator的锁模式 #

在你的@TableGenerator注解里强制指定悲观写锁，确保每次获取序列批次时都能锁住对应行，避免并发冲突：

@Id
@GeneratedValue(strategy = GenerationType.TABLE, generator = "NAME_HERE")
@TableGenerator(
    name = "NAME_HERE",
    table = "SEQUENCE_TABLE_NAME",
    pkColumnName = "Name",
    pkColumnValue = "ENTITY_NAME",
    valueColumnName = "VALUE_COLUMN_NAME",
    allocationSize = 100,
    lockMode = LockModeType.PESSIMISTIC_WRITE // 强制悲观写锁，确保并发安全
)

这个配置是最直接的修复，不需要改数据库结构，适合快速验证。

方案2：调整测试的事务与并行配置 #

• 确保所有涉及数据插入的测试用例都添加@Transactional注解，Spring Test默认会在测试结束后回滚事务，但要避免自定义的事务配置覆盖这个行为。
• 如果构建服务器开启了并行测试，要么关闭并行（临时方案），要么为测试环境单独配置序列表行：比如把测试用的pkColumnValue改成ENTITY_NAME_TEST，和生产环境的序列行隔离，避免测试和生产（或测试之间）的序列冲突。

方案3：验证序列表的状态一致性 #

虽然你提到序列值高于数据库最新值，但还是要确认：

• 序列表中VALUE_COLUMN_NAME的值是否等于当前已用主键最大值 + allocationSize，比如当前最大主键是1000，allocationSize是100，那么序列值应该是1100，这样下一次分配的是1101-1200，不会和已存在的主键重复。
• 检查Hibernate的initialValue配置是否和序列表的初始值一致，5.x对这个参数的校验更严格，不匹配可能导致异常分配。

方案4：长期优化：替换为更稳定的主键生成策略 #

TABLE生成策略本身是性能最低、并发问题最多的一种，如果你的数据库支持，建议换成IDENTITY（自增列）或SEQUENCE（数据库序列）：

// 以SEQUENCE为例（适用于PostgreSQL、Oracle等）
@Id
@GeneratedValue(strategy = GenerationType.SEQUENCE, generator = "NAME_HERE")
@SequenceGenerator(
    name = "NAME_HERE",
    sequenceName = "ENTITY_SEQ",
    allocationSize = 100
)

这个方案从根源上避免了表生成器的锁冲突，但需要修改数据库结构，适合做长期技术优化。

• 在构建服务器上开启Hibernate的SQL日志（添加hibernate.show_sql=true配置），观察序列表的SELECT FOR UPDATE语句是否正常执行，以及每次获取的序列值是否连续不重复。
• 手动在构建服务器的测试数据库中，在测试前后查询序列表的数值，看是否有异常的回滚或重复分配情况。

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