Navicat多分支同步需严格区分结构同步(仅DDL,不处理数据值和默认值)与数据传输(须手动字段映射、加WHERE过滤分支数据、启用事务),并锁定测试库对应分支上下文,否则易致结构错位、数据污染或外键失效。

多分支开发时,直接用 Navicat 同步测试库到本地开发库极易引发结构错位、数据污染或外键失效——根本原因不是操作步骤不对,而是没区分「结构同步」和「数据传输」的职责边界,也没控制好分支间的数据流向。
结构同步只管建表删表,不管字段值
结构同步(工具 → 结构同步)本质是执行 DDL:它比对源(测试库)和目标(本地开发库)的表定义,生成 CREATE / ALTER / DROP 语句。但它完全不碰已有数据,哪怕你勾选了「清空目标表」,也只是在部署前加 TRUNCATE,且仅限于已存在的同名表。
- 不会自动处理新增字段的默认值填充(比如测试库加了
status TINYINT DEFAULT 1,开发库表结构更新后该字段全是 NULL) - 不会迁移视图、函数、存储过程里的分支特有逻辑(例如某个 feature/x 分支用了临时 UDF,结构同步会把它带到 dev 库,但没对应代码)
- 如果测试库是某分支的专属环境(如
test-feature-23),而你用它同步到主干dev库,可能把未合入的索引或约束提前“污染”进主干环境
数据传输必须手动匹配字段映射
数据传输(工具 → 数据传输)负责 INSERT/UPDATE,但 Navicat 默认按字段名直连——一旦分支间存在字段重命名(如 user_name → name)、类型变更(VARCHAR(50) → VARCHAR(100))或新增非空字段,就会报错或写入 NULL。
Navicat Premium 17.1 Windows x64 历史系列获取入口。该系列扩展 Garnet、PolarDB 等连接支持,并增强可视化查询解释与 Redis 树视图;未核实到公开固定安装包直链。
- 每张表点开「字段映射」页,确认源字段和目标字段一一拖拽配对;不能依赖自动识别
- 遇到
NOT NULL column 'xxx' cannot be null错误,先查目标表该字段是否设了 DEFAULT,或在「高级」页勾选「忽略插入错误」前,先手动补全默认值逻辑 - 禁止勾选「删除目标中不存在的记录」——这会清掉开发库独有的调试数据(如本地 mock 用户、测试订单)
同步前必须锁定分支上下文
所谓“测试库”,在多分支场景下可能是多个物理库(test-main、test-feat-a、test-feat-b),也可能是同一库不同 schema。Navicat 不识别 Git 分支,只认连接配置和库名。
- 同步前明确当前开发分支对应哪个测试库实例,切勿用 feature/b 分支的测试库去覆盖 feature/a 的本地开发库
- 检查测试库的
CREATE TABLE语句里是否有分支专属注释(如-- @branch: feat-login-v2),这类标记需人工核对是否应同步 - 若测试库启用了行级版本控制(如通过
branch_id字段隔离数据),数据传输时务必在「SQL 过滤器」里加上WHERE branch_id = 'current-dev-branch',否则会混入其他分支脏数据
外键与事务隔离容易被静默绕过
Navicat 在结构同步中默认禁用外键检查(SET FOREIGN_KEY_CHECKS=0),再用 TRUNCATE 清空表——这能避免外键约束报错,但也会掩盖引用完整性问题。数据传输阶段若未开启事务,大表同步中途失败会导致部分写入、部分丢失。
- 同步完成后立即执行
SELECT * FROM information_schema.KEY_COLUMN_USAGE WHERE TABLE_SCHEMA = 'your_dev_db' AND CONSTRAINT_NAME != 'PRIMARY';,确认外键是否完整重建 - 在数据传输的「高级」页,勾选「在事务中执行」并设置合理超时(如 300 秒),防止长事务锁表
- 如果开发库开启了
READ-COMMITTED隔离级别,而测试库是REPEATABLE-READ,某些时间戳或自增行为可能不一致,需在同步后校验关键业务单据的 ID 连续性
最常被跳过的动作是:没确认测试库的 binlog 格式是否为 ROW(影响触发器和 GTID 兼容性),以及没在同步后验证 SHOW CREATE PROCEDURE 输出是否和测试库完全一致——这两处差异往往要等到上线前压测才暴露。

















