MySQL跨库如何生成结构对比HTML报告_异构迁移实战-navicat-PHP中文网

mysqldiff 是唯一能稳定生成可读 HTML 差异报告的官方跨库结构比对工具，需显式指定不同 host/port 的 server1/server2，支持字段级解析，默认不检查库级字符集需手动核验。

用 mysqldiff 生成跨库结构差异报告最稳

直接上结论：mysql官方工具 mysqldiff 是目前唯一能稳定输出可读 html 差异报告的跨库结构比对方案，不用写脚本、不依赖 python 包、不碰 sql 解析器。

它本质是 MySQL Utilities 套件里的命令行工具，底层走的是 SHOW CREATE TABLE + 字段级解析，不是靠 INFORMATION_SCHEMA 粗暴对比，所以能识别默认值变更、注释差异、索引顺序变化这些容易被忽略的点。

常见错误现象：mysqldiff 报错 Access denied for user 不是因为权限不够，而是没给 --server1 和 --server2 显式指定用户（哪怕都是 root），必须带 user:pass@host:port 格式；另外两个库不能在同一个实例里用不同 database 名来“模拟跨库”，它强制要求物理分离（不同 host 或 port）。

安装方式：MySQL 5.7 自带，8.0+ 需单独装 mysql-utils 包（Debian/Ubuntu 装 mysql-utilities，CentOS/RHEL 用 mysql-community-utils）
基础命令：mysqldiff --server1=root:pass@10.0.1.10:3306 --server2=root:pass@10.0.2.10:3306 db1:db2 --changes-for=server2 --difftype=html > diff.html
--changes-for=server2 表示“以 server2 为目标库，列出让它变成 server1 需要执行的 DDL”——这点反直觉，但决定了生成的 SQL 是否可直接执行
HTML 输出里所有表名、字段名、SQL 片段都自动加了 <code> 标签，不用再加工

mysqldiff 不支持同实例跨 database 的真实原因

它不是偷懒，是设计使然：当 --server1 和 --server2 指向同一 IP+端口时，mysqldiff 会拒绝运行，并报错 Servers must be different。这不是 bug，是为避免误把同一份数据当成两套源来比对。

实际迁移中常遇到“老库在旧实例，新库刚建在新实例”，这时必须确保两个 --serverX 参数的 host/port 完全不同。如果测试环境只有单实例，得用 Docker 启一个临时 MySQL 实例，或改 host 文件伪造两个域名指向同一 IP（port 必须不同）。

绕过方法：用 mysqldump -d 分别导出两个库的结构，再用 diff 或 git diff 对比文本——但丢失字段顺序、索引类型、外键约束等语义信息
更靠谱的替代：用 pt-table-sync --print --sync-to-master（Percona Toolkit），但它只输出同步 SQL，不生成 HTML 报告
注意 mysqldump -d 导出时加 --skip-extended-insert，否则单条 INSERT 变成多行，diff 结果不可读

HTML 报告里哪些差异真会影响迁移

生成的 HTML 里列了一堆“不同”，但不是每项都要处理。重点盯三类：

字段类型不一致：INT vs BIGINT、VARCHAR(255) vs VARCHAR(500)，尤其后者可能触发隐式截断
默认值变更：DEFAULT NULL vs DEFAULT ''，MySQL 8.0+ 对严格模式下空字符串插入行为更敏感
索引定义差异：主键字段顺序不同、联合索引字段数不一致、KEY 和 UNIQUE KEY 类型混用——ORM 或分库中间件可能依赖索引名或顺序
忽略项：COMMENT、AUTO_INCREMENT 当前值、COLLATE 相同但写法不同（如 utf8mb4_0900_ai_ci vs utf8mb4_general_ci）一般不影响功能，除非业务显式依赖排序规则

字符集和排序规则差异怎么不被漏掉

mysqldiff 默认只比对表结构，不检查库级 CHARACTER SET 和 COLLATION。如果 source 库是 utf8mb4，target 库建库时忘了指定，后续插入 emoji 就会失败，但 HTML 报告里完全看不到这行差异。

必须手动补查：SELECT DEFAULT_CHARACTER_SET_NAME, DEFAULT_COLLATION_NAME FROM information_schema.SCHEMATA WHERE SCHEMA_NAME = 'db_name';，两边各跑一次，结果不一致就得提前改 target 库。

建库语句务必显式带上：CREATE DATABASE db2 CHARACTER SET utf8mb4 COLLATE utf8mb4_0900_ai_ci;
如果 target 库已存在且字符集不对，ALTER DATABASE db2 CHARACTER SET utf8mb4 COLLATE utf8mb4_0900_ai_ci; 只改库默认值，已有表不受影响，还得逐个 ALTER TABLE
表级字符集优先级高于库级，所以 mysqldiff 会把表的 CHARSET 差异标出来，但不会提示“库默认值不一致”这种全局风险

跨库结构对比不是比完就完的事，HTML 报告只是起点，真正卡住迁移的往往藏在库级配置、隐式类型转换、或者某个字段的 NOT NULL 约束漏掉了。