PouchDB与CouchDB复制问题：本地修改留存及云端变更同步

嘿，这个场景我之前帮人处理过，刚好是PouchDB和CouchDB同步里典型的「本地修改优先+远程增量同步」需求，给你几个可行的解决方案：

PouchDB默认的同步规则确实是「谁的_rev哈希值更新（不是数值更大）谁覆盖对方」，但你可以通过开启冲突检测，编写自定义逻辑来实现“本地修改留存到远程出新版本为止”的需求。

核心思路是：同步时主动检测冲突，判断本地修改是否还没被远程覆盖——如果远程文档的冲突列表里包含本地的_rev，说明远程还没有针对该文档的新版本，这时候就保留本地修改；如果远程已经有了完全独立的新版本（不在本地冲突列表里），再执行合并或覆盖逻辑。

给你一段实用的代码示例：

// 启动双向同步，开启冲突检测
PouchDB.sync('local-db-name', 'https://your-couchdb-url/db-name', {
  live: true,
  retry: true,
  conflicts: true // 关键：开启冲突检测
}).on('change', async (info) => {
  // 当同步出现冲突时处理
  if (info.conflicts?.length) {
    for (const docId of info.conflicts) {
      // 获取带冲突信息的文档
      const doc = await localDb.get(docId, { conflicts: true });
      
      // 判断本地版本是否还未被远程覆盖
      const isLocalRevUncovered = doc._conflicts.includes(doc._rev);
      
      if (isLocalRevUncovered) {
        // 远程还没有针对该文档的新版本，保留本地修改
        // 这里可以给文档加个标记，方便后续识别
        doc._localModified = true;
        await localDb.put(doc);
      } else {
        // 远程有了新的独立版本，执行业务合并逻辑
        // 比如合并本地和远程的字段，而不是直接覆盖
        const remoteDoc = await remoteDb.get(docId);
        const mergedDoc = {
          ...remoteDoc,
          // 保留本地修改的字段，比如用户编辑的内容
          userContent: doc.userContent,
          _rev: remoteDoc._rev // 基于远程版本更新，避免再次冲突
        };
        await localDb.put(mergedDoc);
      }
    }
  }
}).on('error', (err) => {
  console.error('同步出错:', err);
});

如果不想处理复杂的冲突，你可以换个思路：把本地PouchDB作为用户的首要数据源，远程CouchDB仅作为备份和协同节点。

具体步骤：

• 应用启动时，先从本地PouchDB加载数据，确保用户第一时间看到自己的本地修改；
• 启动从远程到本地的拉取同步，但通过自定义过滤器，只拉取那些本地没有修改过的文档，或者远程更新时间晚于本地修改时间的文档；
• 对于本地已经修改过的文档，暂时跳过拉取，直到远程有明确的新版本（可以通过自定义的updatedAt时间戳判断，而不是依赖_rev）。

比如在CouchDB上创建一个过滤设计文档：

// 上传到CouchDB的设计文档，用于过滤同步内容
{
  "_id": "_design/sync-filters",
  "filters": {
    "only-newer-than-local": function(doc, req) {
      // 只允许远程更新时间晚于本地传入时间的文档同步
      return doc.updatedAt > parseInt(req.query.localUpdatedAt);
    }
  }
}

然后在本地执行拉取：

// 先获取本地所有修改过的文档的最新更新时间
const localModifiedDocs = await localDb.allDocs({
  include_docs: true,
  selector: { _localModified: true } // 用之前加的标记筛选
});
const latestLocalUpdateTime = localModifiedDocs.rows.reduce((max, row) => {
  return Math.max(max, row.doc.updatedAt || 0);
}, 0);

// 拉取远程变更时，跳过本地已经修改过且远程没有更新的文档
await localDb.replicate.from('https://your-couchdb-url/db-name', {
  filter: 'sync-filters/only-newer-than-local',
  query_params: { localUpdatedAt: latestLocalUpdateTime.toString() }
});

• 别依赖_rev判断业务新旧：_rev是哈希值，它的“大小”不代表业务上的更新顺序，建议给每个文档加updatedAt时间戳字段，更直观判断版本；
• 冲突处理要明确：一定要提前定义好“本地修改和远程新版本冲突时怎么合并”的规则，比如保留本地编辑的内容、合并字段等，避免数据丢失；
• 测试边缘场景：比如本地修改后，远程也修改了同一个文档，这时候要确保你的逻辑能正确识别并处理。

内容的提问来源于stack exchange，提问作者georges rolland