知识库故障排查ZCenter 数据库 Flyway 迁移失败排查

ZCenter 数据库 Flyway 迁移失败排查

故障排查ZVF · ZCenter适用版本5.1.0文章 IDKB-200006更新于2026-08-05

问题说明

本文用于排查 ZCenter 启动或升级期间的 Flyway 数据库迁移失败问题。

现象

  • ZCenter 启动或升级时数据库迁移失败。
  • 迁移过程出现 checksum mismatch、表已存在或版本号冲突等错误。

适用环境

  • 产品线:ZVF
  • 组件:ZCenter
  • 版本:5.1.0

可能原因

  • 已执行的迁移脚本被修改,导致校验和不一致。
  • 上一次迁移中断后残留数据表,重试时提示表已存在。
  • 新增迁移脚本的版本号未严格递增,与已执行版本冲突。

ZCenter 使用 Flyway 管理数据库版本,迁移脚本命名规则为 V{version}__schema.sql

登录查看余下内容,以及更多产品问题排查与解决经验。