Obsidian-LiveSync同步失效问题分析与解决方案

问题背景

近期部分Obsidian-LiveSync用户反馈在Windows 10和iOS设备间出现同步失效现象。典型表现为：

1. 设备间文件无法同步
2. 反复出现"Scram enabled"提示
3. 重建数据库操作无效
4. 同步状态持续异常

根本原因分析

经过技术排查，发现主要诱因包括：

1. Git仓库干扰
   当用户同时使用Obsidian Git插件时，.git目录中的大量版本控制文件会被误识别为同步内容，导致：

• 同步任务超载（单案例显示4000+文件待同步）
• 数据库体积异常膨胀（1.7GB vs 实际44MB库容）

2. 配置参数冲突
   部分用户的"Hidden file sync"开启状态与".git"目录忽略规则未正确配合

3. 加密模式异常
   SCRAM加密机制在某些网络环境下可能出现握手失败

解决方案

方案一：基础配置调整

1. 在插件设置中确认已添加\/.git\/到忽略规则
2. 关闭"Hidden file sync"选项（如无需同步隐藏文件）
3. 手动禁用SCRAM模式：
   • 进入LiveSync高级设置
   • 关闭"Enable SCRAM"开关
   • 重启Obsidian

方案二：数据库重建

1. 备份当前数据
2. 执行"Rebuild everything"操作
3. 确保所有设备采用相同的忽略规则

方案三：P2P同步替代

当CouchDB服务异常时：

1. 启用LiveSync的P2P功能
2. 通过局域网直连设备
3. 注意可能需要多次尝试建立稳定连接

技术建议

1. 版本控制整合
   建议Git用户明确设置.git目录排除规则，或考虑使用.obsidian/ignore文件统一管理

2. 性能优化
   大型库（>1000文件）建议：

• 设置batch_size=30
• 启用skipOlderFilesOnSync
• 限制syncMaxSizeInMB=50

3. 日志分析
   遇到同步故障时：

• 启用Verbose Log模式
• 检查是否存在重复同步请求
• 确认网络请求返回状态码

后续维护

用户反馈P2P方案最终解决了同步问题，但开发者建议：

1. 定期检查数据库体积增长情况
2. 跨平台使用时注意文件系统大小写敏感差异
3. 复杂场景可考虑分库同步策略

该案例表明，同步类工具需要特别注意版本控制系统和隐藏文件的处理策略，合理的排除规则是保证同步稳定性的关键因素。