Flyway可通过环境隔离(flyway.toml中environments.test/prod)和按数据库分目录的SQL脚本(如sql/mysql/与sql/postgresql/)实现测试库(MySQL)与生产库(PostgreSQL)的异构迁移;禁止在V脚本中写跨库逻辑,数据同步宜用JavaMigration做清洗,校验用分段采样+row_hash比对,禁用dump/restore因语法与类型不兼容。
怎么用 Flyway 管理测试库和生产库的异构迁移
flyway 本身不直接支持“双库并行迁移”,但它能帮你把结构变更(ddl)和数据初始化(dml)拆开控制,让测试库和生产库走不同路径——关键在 flyway.toml 的环境隔离和脚本命名约定。
实操建议:
- 用
[environments.test]和[environments.prod]分别定义 MySQL 测试库、PostgreSQL 生产库的连接参数,避免硬编码 - 迁移脚本按数据库类型分目录:比如
sql/mysql/V1__init.sql和sql/postgresql/V1__init.sql,Flyway 会根据当前driver自动选对应目录下的脚本 - 禁止在
V开头的版本脚本里写跨库逻辑(如 INSERT INTO target SELECT * FROM source),这类操作必须抽成R(可重复)脚本或 Java 迁移类,否则回滚/重跑会出错 - 测试库可以启用
flyway.cleanOnValidationError=true,但生产库绝对禁用——它会在校验失败时直接删库
为什么不能直接 dump + restore 跨异构库做无损发布
因为 mysqldump 输出的是 MySQL 语法,pg_dump --inserts 输出的是 PostgreSQL 语法,两者字段类型、默认值、约束写法、时间函数(如 NOW() vs CURRENT_TIMESTAMP)全都不兼容。硬导会报错,或者静默丢数据。
常见错误现象:
-
ERROR: column "created_at" is of type timestamp without time zone but expression is of type text—— 源库导出时没转类型,目标库拒绝插入 - MySQL 的
TINYINT(1)被当布尔导入 PostgreSQL,结果变成整数 0/1,应用层解析失败 - Oracle 的
DATE类型含时分秒,但 MySQL 的DATE只存日期,迁移后时间信息被截断
所以 dump+restore 只适用于同构迁移(如 MySQL → MySQL),异构场景必须加一层转换逻辑。
Java 迁移类怎么处理跨库数据同步的脏数据
当你要把测试库中某张表的增量数据同步到生产库(比如补测期间产生的订单),用纯 SQL 很难兜住空值、时区、字符集等边界问题,这时 JavaMigration 是更可控的选择。
实操建议:
- 继承
BaseJavaMigration,在migrate()方法里用JdbcTemplate分批查源库、构造Map再批量写入目标库,中间可插清洗逻辑 - 对
TEXT/CLOB字段,显式调用setCharacterStream()避免 Oracle JDBC 的ORA-01461错误 - 别在 Java 迁移里做事务跨库提交——源库 commit 和目标库 commit 无法原子性保证,要用补偿机制(比如记录同步位点表)
- 生产环境运行前,先在测试库用相同数据跑一遍,检查日志里有没有
WARN: truncated data for column这类 JDBC 警告
上线窗口内如何验证迁移后数据一致又不锁表
停机窗口短、业务不能停,就不能用 SELECT COUNT(*) 或全量比对。得靠采样校验 + 差异定位。
使用场景:
- 用
pt-table-checksum(Percona Toolkit)生成校验码,再用pt-table-sync输出差异 SQL —— 但它只支持 MySQL 生态,跨库需改写 - 更通用的做法:对关键表加
MD5(CONCAT(...所有非BLOB字段...)) AS row_hash,在源库和目标库分别聚合出GROUP BY row_hash HAVING COUNT(*) != 1,快速定位不一致行 - 注意:PostgreSQL 的
md5(text)和 MySQL 的MD5()对 NULL 处理一致,但对空字符串、空白符敏感,比对前统一TRIM(COALESCE(col, '')) - 千万别在生产库主键上加临时索引做校验——可能阻塞写入,改用已有索引字段(如
created_at+id)分段采样
最容易被忽略的是时区和默认值行为差异:比如 MySQL 5.7 默认 datetime 不自动设当前时间,而 PostgreSQL 的 timestamp with time zone 在 INSERT 时会自动绑定 session timezone。这种隐式行为不写进迁移脚本,上线后数据就“看起来对、其实偏了”。










