Spring Cloud Stream Schema Registry 4.0.2序列增量需设为50的疑问

为什么需要增量50？ #

这个50的序列增量值并非来自Schema实体类的显式配置，而是Hibernate的默认序列生成策略参数。Spring Cloud Stream Schema Registry 4.0.2依赖的Spring Boot 3.x系列对应的Hibernate版本中，对于使用SEQUENCE策略生成ID的实体，默认的allocationSize（即序列步长）就是50。

配置来源 #

查看Schema实体类的ID字段配置，应该是仅使用了@GeneratedValue(strategy = GenerationType.SEQUENCE)注解，但未显式指定allocationSize。此时Hibernate会自动启用默认的池化ID生成器，默认分配大小设为50——目的是减少数据库序列的调用次数，提升性能：Hibernate会一次性预取50个ID值，在内存中分配，避免每次插入都请求数据库序列。

之前版本无此要求，是因为旧版本对应的Spring Boot/Hibernate版本要么默认使用的ID生成策略不同（比如IDENTITY），要么默认的allocationSize参数值不是50，或者实体类显式配置了更小的步长。

测试环境的解决逻辑 #

Hibernate要求数据库中序列的INCREMENT BY值必须和实体映射的allocationSize完全一致，否则会抛出你遇到的映射异常。因此在Flyway迁移脚本或Testcontainer初始化时，必须创建增量为50的序列：

CREATE SEQUENCE schema_repository_seq INCREMENT BY 50 START WITH 1;

如何修改增量值（可选） #

如果需要调整序列步长，有两种方式：

• 实体类显式配置：在Schema实体的ID字段上添加@SequenceGenerator注解，指定allocationSize为目标值，示例：

  @Id
  @GeneratedValue(strategy = GenerationType.SEQUENCE, generator = "schemaRepositorySeq")
  @SequenceGenerator(name = "schemaRepositorySeq", sequenceName = "schema_repository_seq", allocationSize = 1)
  private Long id;
  

• 全局配置：通过Hibernate属性修改默认值，比如在application.properties中添加：

  hibernate.id.optimizer.pooled.preferred=pooled-lo
  hibernate.id.optimizer.pooled.initial_size=1
  

  不过不建议随意修改默认值，50的步长是Hibernate经过性能优化后的默认设置，能有效减少数据库交互次数。

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