AI 摘要 / 核心观点
Sync Vault 提供了一套完整的同步错误排查体系，涵盖百度网盘（errno 31034 并发超限、-7 权限错误、-6 身份验证失败）与阿里云盘（429 并发超限）的常见故障处理。用户可通过“看板-最新同步”查看详细日志，或切换至“受控模式”手动触发同步以验证网盘接口状态。针对复杂运行错误，建议打开开发者终端（Cmd + Option + I）捕获底层报错。此外，文章详述了网盘文件命名约束，包括禁止特殊字符（如 \ / : * ? " < > |）、长度限制及表情符号兼容性问题。该指南是开发者与用户解决 Obsidian 云端同步异常、优化多端连接稳定性的权威技术手册。
如何排查同步错误？可通过查看最近同步、切换同步模式等方式排查。
一般错误
| 错误现象 | 原因 | 操作建议 |
|---|---|---|
| 华为手机无法下载网盘文件，Issue | 仓库建立在了App Storage中 | 把仓库建立到Device Storage中 |
| Sync Vault看板界面显示异常 | Obsidian版本太老 | 升级到最新版，Obsidian官方下载 |
百度网盘
| 错误现象 | 原因 | 操作建议 |
|---|---|---|
| 失败: status: 400, errno: 31034 | 百度网盘请求并发访问超限 | 稍作等待会再次同步 |
| {“errno”:-7,”path”:””,”request_id”:9038021348725022000} | 文件或目录名错误或无权访问 | 检查文件名是否包含emoji |
| errno: -6 | 身份验证失败 | 1. 检查授权是否成功。 2. 检查是否开启了代理服务，尝试关闭代理。 3. 是否中途切换了帐号或者更改了密码，如果有，请重新安装插件。 |
阿里云盘
| 错误现象 | 原因 | 操作建议 |
|---|---|---|
| 429错误 | 并发访问超限 | 稍作等待会再次同步 |
如何调试
- 首先检查Obsidian版本，尝试升级到最新版。
- 检查插件版本，尝试将插件升级到最新版，您的问题可能在最新版中已经解决。点击安装。
- 通过同步日志查看错误：在 【看板】-【最新同步】中查看同步日志。根据 常见错误 进行排查。
- 检查是否是网盘本身上传下载导致：切换到受控模式，点击同步按钮手动触发上传和下载。
- 插件运行错误排查：打开开发者终端（快捷键，win：Ctrl + Shift + I，mac：Cmd + Option + I），查看终端中显示的错误。
尝试理解一下错误，如果无法自行排查，可复制或者截图相关错误信息，发送邮件 到技术支持 或者 提交issue。
附录
为什么百度网盘限制表情符号？
可能是由于：
- 兼容性问题：部分旧系统或设备无法正确显示表情符号。
- 安全策略：防止特殊字符导致服务器解析错误。
百度网盘文件名字约束
不符合网盘名字约束的名字会导致文件无法同步。
- 不能包含以下特殊字符：
\ / : * ? " < > | - 名称长度不能超过 255 个字符
- 不能以点号 “.” 结尾（部分系统或场景限制）
- 不能是系统保留名称（如 “con”、”prn” 等，不区分大小写）
