从PouchDB到CouchDB复制数据失败，实时同步实现遇阻求助

我来帮你一步步排查这个复制同步失败的问题，先从代码细节和常见坑点入手：

1. 先补上关键的错误监听（最优先级） #

你的代码目前只监听了complete事件，但完全没有处理错误场景——这会导致你根本不知道同步失败的具体原因！首先给复制和同步操作加上错误监听：

['tableA', 'tableB', 'tableC'].forEach(name => { 
  let local = new PouchDB(name, { auto_compaction: true }) 
  let server = new PouchDB(`${serverUrl}/${name}`) // 先修正URL拼接的潜在问题
  var filtro = { 
    include_docs: true, 
    filter: 'replication/by_dispositivo', 
    query_params: { 'dispositivo_id': obj.deviceId } 
  } 
  local.replicate.from(server, filtro)
    .on('complete', report => { 
      console.log(`初始复制${name}完成`, report);
      var sync = local.sync(server, { 
        live: true, 
        retry: true, 
        ...filtro 
      })
      // 给实时同步加错误监听
      sync.on('error', err => {
        console.error(`实时同步${name}出错:`, err);
      });
      sync.on('change', change => {
        console.log(`${name}同步变更`, change);
      });
    })
    // 给初始复制加错误监听
    .on('error', err => {
      console.error(`初始复制${name}失败:`, err);
    });
})

加上日志后，你就能在控制台看到具体的错误信息（比如权限问题、过滤器不存在、跨域错误等），这是定位问题的核心。

2. 检查过滤器函数的有效性 #

你使用了自定义过滤器replication/by_dispositivo，这是最容易出问题的点：

• 确认CouchDB对应的数据库中，存在_design/replication设计文档，且该文档的filters字段下有by_dispositivo函数
• 过滤器函数必须正确接收doc和req参数，并返回布尔值，示例正确写法：

// CouchDB _design/replication文档中的filters.by_dispositivo
function(doc, req) {
  // 确保doc包含dispositivo_id字段，且和传入的参数匹配
  return doc.dispositivo_id === req.query.dispositivo_id;
}

如果过滤器不存在、路径写错，或者逻辑错误，复制会直接失败。

3. 修正同步配置的参数冲突 #

local.sync()是双向同步（同时拉取和推送），你直接扩展filtro参数可能会有问题：

• include_docs参数在同步中是多余的，同步默认会包含完整文档，无需额外设置
• 如果你的过滤器只需要在**拉取（从CouchDB到PouchDB）**时生效，应该单独配置拉取的过滤器，避免影响推送：

var sync = local.sync(server, { 
  live: true, 
  retry: true,
  pull: {
    filter: 'replication/by_dispositivo',
    query_params: { 'dispositivo_id': obj.deviceId }
  },
  // 如果推送不需要过滤，可以留空或者设置其他规则
  push: {}
})

双向同步时，过滤器需要同时适配两个方向，否则可能导致推送失败。

4. 排查跨域（CORS）与权限问题 #

如果是在浏览器环境下使用PouchDB，这两个问题非常常见：

• CORS配置：登录CouchDB的Fauxton管理界面，进入配置→CORS，设置Origin为*（开发环境）或者你的前端域名，同时开启Credentials
• 数据库权限：确认访问CouchDB的用户，对tableA/tableB/tableC这几个数据库拥有_reader和_writer权限，没有权限会直接拒绝复制请求

5. 检查数据库URL拼接是否正确 #

如果serverUrl结尾没有斜杠，比如http://your-couchdb.com，那么serverUrl + name会变成http://your-couchdb.comtableA，这显然是无效的URL。建议用模板字符串拼接：

let server = new PouchDB(`${serverUrl}/${name}`)

确保最终的URL是类似http://your-couchdb.com/tableA的正确格式。

6. 版本兼容性检查 #

确认你使用的PouchDB版本和CouchDB版本兼容：

• PouchDB 7.x+ 建议搭配 CouchDB 2.x+
• 如果使用了较旧的PouchDB版本，某些同步API可能有差异，建议升级到稳定版

先按上面的步骤排查，尤其是先加上错误监听，拿到具体的错误信息后，就能更精准地定位问题了。

内容的提问来源于stack exchange，提问作者Tobias Mesquita