必须禁用navicat自动执行prod→dev结构同步,因其默认生成drop语句破坏开发环境一致性;正确做法是仅生成sql文件,人工审核后提取安全ddl语句在测试库验证执行。
不能直接用 navicat 结构同步功能自动执行 prod → dev 或 prod → staging 的结构变更——这是高危操作,不是配置问题,而是设计逻辑缺陷。
为什么“PROD → DEV”方向必须禁用自动执行
Navicat 不区分「上线」和「下放」场景,只认「源」与「目标」。当你把生产库设为源、开发库设为目标时,它默认会生成 DROP TABLE、DROP COLUMN、DROP INDEX 等语句去“收敛”结构——而开发库本就不该有某些表(比如 audit_log),删掉反而破坏环境一致性。
-
Drop objects not exist in source默认勾选,这是为「结构收敛」设计的,不是为「结构下放」 - 开发库常含调试字段、临时索引、测试数据,这些在生产库不存在,会被一并删除
- 一旦执行失败(如权限不足、锁表),部分 DDL 已生效,开发环境进入半残状态,恢复成本远高于重装
正确做法:只生成 SQL 文件,不点 Run
目标不是让 Navicat 去改库,而是让它帮你生成一份可审计、可复现、可分发的结构快照。
- 打开结构同步向导,左面板选
PROD_MySQL_OrderDB(源),右面板选DEV_MySQL_OrderDB(目标) - 在
Compare options页,务必取消勾选Drop objects not exist in source和Ignore auto-increment value - 点击
比较后,**不要点Run**,直接点Save as SQL File,保存为prod_struct_20260727.sql - 交付时附说明:“此脚本仅用于参考,严禁直接执行;如需更新本地结构,请手动提取 CREATE/ALTER 语句,在本地测试库验证后再应用”
开发团队拿到脚本后必须做的三件事
Navicat 生成的脚本是起点,不是终点。跳过人工核对等于埋雷。
-
SHOW CREATE TABLE order_header\G在生产库执行,复制完整输出,与脚本逐行比对——脚本不显式声明COLLATE utf8mb4_0900_as_cs或CHARSET=utf8mb4,直接套用可能导致中文乱码 - 过滤掉所有
DROP和RENAME语句,只保留CREATE TABLE、ADD COLUMN、MODIFY COLUMN等安全操作 - 补全
NOT NULL字段的DEFAULT值(Navicat 不自动生成),否则ALTER TABLE ... ADD COLUMN xxx NOT NULL会在有存量数据时失败
同步前必须确认的三件事
结构同步本质是批量执行 DDL,不是魔法。漏查任何一项都可能中断服务。
- 源库与目标库的 MySQL 版本是否兼容?例如
JSON类型无法同步到 MySQL 5.6 - 目标库账号是否具备
ALTER、CREATE权限?只给SELECT和INSERT是不够的 - 目标库是否存在同名但已手动修改过的表?Navicat 不检测“该表上周被 DBA 加了唯一索引”,也不会跳过冲突
真正容易被忽略的,是字符集声明缺失和 NOT NULL 字段缺 DEFAULT 值这两处——它们不会在比对阶段报错,却会在执行时卡死,且错误信息模糊(常见报错:ERROR 1138: Invalid use of NULL value)。务必用 SHOW CREATE TABLE 对关键表做最终校验。











