navicat cloud 同步失败主因是三个硬性开关未开启、状态未确认、路径未对齐；同步状态栏显示“syncing…”或“paused”需手动恢复；网页端修改不会自动推送至桌面端，须右键“从云重新加载”；connections、backup tasks、ssl证书等本就不在同步范围内。
navicat cloud 同步失败不是网络卡顿或账号异常的锅，而是三个硬性开关没打开、状态没确认、路径没对齐——缺一不可。
同步状态栏显示“Syncing…”或“Paused”怎么办
右下角状态栏不是装饰，它是唯一可信的同步健康指示器。显示“Syncing…”说明有任务卡住；显示“Paused”说明你手动停了，或触发了自动暂停策略（比如连续失败 3 次）。
- 点击状态栏 → 选「Resume Sync」强制恢复，不是等它自己重试
- 若持续卡在 Syncing，关掉 Navicat，删掉本地同步缓存目录：
%APPDATA%PremierSoftNavicatCloudCache（Windows）或~/Library/Caches/com.premiersoft.navicat.*（macOS），再重启 - 别依赖「自动重连」——Navicat 不会后台重试失败项，必须手动刷新项目节点或重启客户端
为什么网页端能看到查询，但桌面端没更新
Navicat Cloud Portal（navicat.com/cloud）和桌面客户端是两个独立同步通道，网页端修改不会自动推送到你本地，除非你主动拉取。
- 在桌面端右键对应项目 → 选「从云重新加载」，不是「刷新」（后者只刷本地缓存）
- 检查网页端该项目的「同步范围」设置：必须勾选
Queries、Code Snippets等具体条目，光开「同步开关」不生效 - macOS 用户若用 Apple ID 登录系统，常因凭据冲突导致桌面端静默登录失败：进 Navicat 设置 → 账号 → 先「退出」再重新输入 Navicat ID 和密码
连接、备份、SSL 证书这些怎么都不同步
不是同步失败，是它们根本不在同步清单里。Navicat Cloud 明确排除三类东西：Connections、Backup Tasks、SSL Certificate Files——所有报错“连不上”“证书没了”“备份计划消失”，都是误以为它们该同步。
-
Connections只同步分组名、标星、着色等 UI 元数据，主机/端口/密码/SSH 路径全部本地加密存储，导出.navicat_project文件也空着这部分 -
Backup Tasks依赖本地路径和系统定时服务，配置存在backup.xml或 SQLite 中，换电脑必须重配，复制文件大概率路径错乱 -
SSL CA File必须是本地绝对路径，填\servercertsca.pem或~/certs/ca.pem都会被静默忽略，且路径中不能含空格、中文、符号链接
同步后 SSH 隧道失效、私钥“不见了”
Navicat 同步的只是私钥的路径字符串，不是密钥内容本身。Mac 上的 /Users/alice/.ssh/id_rsa 到 Windows 上就是个无效路径，Navicat 连试都不试，直接跳过隧道走直连。
- 团队必须约定统一存放位置，比如每人本地建
C: avicat-ssh或~/navicat-ssh/，把私钥复制进去并重命名一致（如jumpbox_key） - 连接设置里填完整绝对路径：
C: avicat-sshjumpbox_key，不要用相对路径（部分版本不支持）或波浪号 - 改完必须点「Save」再点「Test Connection」——只点测试不保存，下次打开还是旧配置
真正卡住同步的，从来不是功能坏了，而是你试图让 Navicat Cloud 做它设计上就拒绝做的事：传密码、管备份、读网络证书、同步私钥文件。看清边界，比反复重试更省时间。
