结构同步方向须以左侧为源、右侧为目标,操作前应确认状态栏提示“将对[左侧库名]应用更改”,并逐条核对DDL差异,忽略无关元数据变更,确保连接可用且高级对象手动勾选比对。

确认源库和目标库方向是否正确
结构同步默认以左侧为源、右侧为目标,但界面只显示“数据库1”“数据库2”,不标注源/目标。一旦拖错,生成的 ALTER TABLE 脚本会反向执行——比如你想把 test_old 升级成 test_new 的结构,结果脚本却去删 test_new 的字段。
实操建议:
- 打开结构同步窗口后,先把「当前要更新的那个库」拖到左侧(即源),「作为基准的那个库」拖到右侧(即目标)
- 点击比对后,紧盯顶部状态栏是否显示“将对 [
左侧库名] 应用以下更改”——这是唯一能快速验证方向正确的提示 - 发现方向错了别点部署或运行,直接关闭重开,重新拖拽顺序
每条差异都必须点开 DDL 比较面板核对
Navicat 标黄的“修改”不等于业务变更。常见现象是字段名、类型、长度完全一致,却标为黄色“修改”,点开 DDL 比较 标签才发现只是 COLLATE utf8mb4_0900_as_cs 和 COLLATE utf8mb4_unicode_ci 不同。这类元数据差异不影响查询逻辑,但会触发 ALTER TABLE CONVERT TO CHARACTER SET,可能锁表或引发隐式转换。
实操建议:
- 每条差异项都要点开底部的
DDL 比较标签,重点盯CHARACTER SET、COLLATE、COMMENT、ENGINE这几处 - 确认是无关差异后,右键该条目 → 选择“忽略此项”;Navicat 不支持批量忽略或按规则过滤,必须逐条手动点
- 索引差异尤其要肉眼核对:字段顺序、前缀长度(如
col_b(10)vscol_b)、排序方向(ASC/DESC)等细节,Navicat 默认不展开
确保连接真实可用,避免静默跳过表
很多“比对失败”或“部分表没出现”根本不是功能异常,而是连接本身不可靠。Navicat 结构同步依赖完整读取 INFORMATION_SCHEMA 和执行 SHOW CREATE TABLE,如果源库权限受限、网络抖动,或 Docker 实例禁用了 INFORMATION_SCHEMA 查询,比对会静默跳过表,甚至报 Access denied for user。
安装、修复、更新或打包一个基于 Python 和 PyMySQL 实现的 Windows `mysql` 命令。适用于用户希望在 PowerShell/CMD 中输入 `mysql` 时重定向到 Python 实现、需要交互式输入 MySQL 连接信息、需要同步到当前用户本地 bin 目录,或需要将该能力封装成可公开复用的 Codex skill。
实操建议:
- 在两个连接上分别手动执行
SELECT COUNT(*) FROM INFORMATION_SCHEMA.TABLES WHERE TABLE_SCHEMA = 'your_db_name';,确认返回数量一致 - 挑 1–2 个典型表(如
t_user),运行SHOW CREATE TABLE `t_user`;,看是否返回完整建表语句(注意反引号不能丢) - 若源库是本地 Docker 实例,检查是否禁用了
INFORMATION_SCHEMA查询(某些轻量版 MySQL 镜像默认关闭)
视图、存储过程等高级对象需手动勾选比对
结构同步默认只比表和字段,但升级中真正影响功能的往往是视图定义变、存储过程逻辑改、触发器失效。这些对象不会自动出现在比对结果里,必须提前在同步设置中显式启用。
实操建议:
- 进入结构同步窗口前,点击右下角的
Options→ 勾选比对视图、比对存储过程、比对触发器等对应项 - 比对完成后,它们会以独立分类出现在结果列表中,同样需要逐条点开
DDL 比较查看定义差异 -
COMMENT内容差一个空格也会标红,索引字段顺序不一致(如(a,b)vs(b,a))会被识别为两个不同索引,这些都得靠人工确认
最易被忽略的是:DDL 比较面板里显示的 SQL 是最终执行依据,而列表页的“操作类型”只是粗略摘要。哪怕只有一行 COLLATE 差异,也可能导致线上 ALTER 锁表数分钟——所以别跳过点开那一下。










