Quarkus+PostgreSQL+Liquibase更新序列allocationSize时出现不一致错误

问题描述 #

修改实体类的@SequenceGenerator的allocationSize为100，同时通过Liquibase执行alter sequence ID_SEQ increment by 100;脚本后，启动应用时收到错误：

Schema-validation: sequence [ID_SEQ] defined inconsistent increment-size; found [1] but expecting [100]

排查与解决步骤 #

1. 验证数据库中序列的实际增量值 #

先确认数据库里的序列增量是否真的被修改，执行PostgreSQL查询：

-- 如果序列名是小写（PostgreSQL默认行为）
select increment_by from information_schema.sequences where sequence_name = 'id_seq';

-- 如果创建序列时用了双引号（保留大写）
select increment_by from information_schema.sequences where sequence_name = 'ID_SEQ';

如果查询结果还是1，说明Liquibase脚本未生效，按以下步骤处理：

脚本未生效的解决：

• 检查Liquibase配置：确认application.properties中quarkus.liquibase.change-log指向的变更日志文件正确，且脚本被包含在日志中。
• 修正序列名大小写：PostgreSQL默认会将未加双引号的标识符转为小写，若创建序列时未用双引号，脚本中应使用小写序列名：

  alter sequence id_seq increment by 100;
  

• 查看Liquibase执行日志：启动应用时查看日志，确认该变更脚本是否被执行，是否有报错信息（比如权限不足、序列不存在等）。

2. 调整Quarkus中Liquibase与Hibernate的执行顺序 #

如果数据库中序列增量已经是100，但仍报错，大概率是Hibernate的schema验证在Liquibase脚本执行之前触发了。

修改application.properties配置：

# 关闭Hibernate自动生成schema，由Liquibase全权负责
quarkus.hibernate-orm.database.generation=none
# 确保Liquibase在应用启动时先执行变更
quarkus.liquibase.migrate-at-start=true

同时确认实体类上的@SequenceGenerator的sequenceName与数据库中的序列名完全一致（包括大小写）。

3. 清除缓存并重启应用 #

若以上步骤都完成仍报错，尝试：

• 重启Quarkus应用，清除Hibernate的缓存，避免旧的序列配置被缓存。
• 若使用了开发模式，执行./mvnw clean清除构建缓存后再启动。

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