navicat通过ssh隧道同步数据需先确保隧道连通且数据库连接参数主机填127.0.0.1；必须使用data synchronization（非data transfer）功能，依赖主键/唯一键映射比对差异，并通过手动添加where条件（如updated_at > '2026-07-20'）实现增量逻辑。
navicat 通过 ssh 进行数据同步，本质是「先建隧道、再走同步」——ssh 只负责连接通道，真正的同步逻辑由 data synchronization 或 data transfer 功能执行。只要源库和目标库都可通过 ssh 隧道连通，跨服务器同步就成立；但很多人卡在连接阶段，根本没走到同步步骤。
SSH 连接必须填对“本地地址”
这是最常踩的坑：在 SSH 隧道配置里，数据库连接参数中的 主机名/IP地址 必须填 127.0.0.1 或 localhost，不能填远程服务器公网 IP。
- 原因：SSH 隧道已把你的本机端口映射到远程服务器的本地回环，数据库服务实际只监听
127.0.0.1:3306（或对应端口） - 填错表现：
Connection refused或Can't connect to MySQL server - 验证方式：在 Navicat 中单独测试该 SSH 连接能否成功打开数据库连接，成功后再进同步流程
数据同步必须用 Data Synchronization，不是 Data Transfer
Data Transfer 是单向搬运（结构+数据），适合初始化迁移；Data Synchronization 才支持双向比对、按主键识别增删改，这才是真正意义上的“同步”。
- 入口路径：菜单栏
Tools → Data Synchronization（不是Data Transfer） - 关键区别：
Data Synchronization会生成差异脚本并预览，支持勾选/取消某张表、某几行的操作；Data Transfer默认全量覆盖，不校验主键 - 若目标库已有数据，误用
Data Transfer并勾选Delete records not exist in source，可能直接清空目标表
同步前必须确认主键或唯一键映射正确
Navicat 同步依赖键字段做记录匹配。如果源表和目标表主键名不一致（比如源是 id，目标是 user_id），或者某张表没设主键，同步会跳过该表，或报 Cannot find primary key 错误。
- 进入 Step 2（表映射）后，点开每张表的
Key Mapping，手动指定用于比对的字段组合 - 不推荐用非唯一字段（如
name）当同步键，容易导致重复插入或漏更新 - 若表无主键但有业务唯一字段（如
order_no），可在 Key Mapping 中显式添加，并确保该字段在两边都为 NOT NULL + UNIQUE
增量同步得靠自定义 WHERE 条件，不是开关按钮
Navicat 没有“增量同步”一键开关。所谓增量，是在 Data Synchronization 的 Options 里给每张表加 WHERE 条件，比如 updated_at > '2026-07-20'。
- 这个条件只作用于本次同步的读取范围，不会自动记住上次时间戳
- 想自动化，得靠外部脚本替换 SQL 中的日期值，再调用 Navicat CLI（需 Premium 版本）或配合 Windows 任务计划程序触发
- 注意时区：源库和目标库的
updated_at字段必须是同一时区时间，否则漏数据
真正麻烦的不是操作步骤多，而是每个环节都依赖前置状态稳定：SSH 隧道通了不代表数据库权限够，表能连上不代表主键定义一致，预览显示“0 行变更”也不代表数据真一致——它只按你当前配的键和 WHERE 条件算。动手前，先在两个连接里分别查一下 SELECT COUNT(*) 和 SHOW CREATE TABLE 对一对，比盲目点同步保险得多。
