React-Native中PouchDB的.replicate.to()同步失败，.from()正常求助

你提供的同步代码如下：

import PouchDB from 'pouchdb-react-native' 
let company_id = await AsyncStorage.getItem('company_id'); 
let device_db = new PouchDB(company_id, {auto_compaction: true}); 
let remote_db = new PouchDB('https://'+API_KEY+'@'+SERVER+'/'+company_id, {ajax: {timeout: 180000}}); 
device_db.replicate.to(remote_db).then((resp) => { 
  console.log(JSON.stringify(resp)); 
  console.log("Device to Remote Server - Success"); 
  return resp; 
}, (error) => { 
  console.log("Device to Remote Server - Error"); 
  return false; 
}); 

执行后得到的成功响应：

{ 
  "ok":true, 
  "start_time":"2018-05-17T15:19:05.179Z", 
  "docs_read":0, 
  "docs_written":0, 
  "doc_write_failures":0, 
  "errors":[ ], 
  "last_seq":355, 
  "status":"complete", 
  "end_time":"2018-05-17T15:19:05.555Z" 
} 

但远程数据库中找不到本地应用可查询到的文档，针对你的问题逐一解答：

1. 你可能忽略的关键要点 #

从同步响应里的docs_read: 0和docs_written: 0就能看出核心问题：本地数据库没有读取到任何需要同步的文档，不是同步过程失败，而是根本没有可同步的文档被纳入复制队列。常见的忽略点包括：

• 本地文档是否正确包含_id和_rev字段？PouchDB依赖这两个字段识别有效文档，如果你手动创建文档时遗漏，或者保存文档的异步操作未完成就触发同步，都会导致文档不被识别。
• 本地库的company_id是否和远程库名称完全一致？如果AsyncStorage获取的company_id有误，你连接的是一个空的本地库，自然没有文档可同步。
• 是否存在隐性的筛选逻辑？比如本地库的文档是否被标记为已删除（_deleted: true），或者你之前设置过复制过滤器但忘记移除。

2. 实用的排查方法 #

按以下步骤逐步定位问题：

• 先确认本地库确实存在目标文档：在同步前添加代码查询本地库内容，验证文档数量和结构：

  device_db.allDocs({include_docs: true}).then(res => {
    console.log("本地文档总数：", res.rows.length);
    console.log("本地文档详情：", res.rows.map(row => row.doc));
  });
  

  重点看每个文档是否有_id和_rev，以及是否是你预期要同步的内容。
• 开启PouchDB调试日志，查看同步细节：启用复制模块的日志，能看到哪些文档被选中、跳过或拒绝：

  PouchDB.debug.enable('pouchdb:replicate'); // 开启复制日志
  device_db.replicate.to(remote_db, {
    live: false,
    retry: false,
    heartbeat: 1000
  }).then(resp => {
    console.log("同步响应：", resp);
  }).catch(err => {
    console.error("同步错误详情：", err);
  });
  

• 测试单文档手动推送：挑一个本地存在的文档，直接用put方法推送到远程，验证基础写入权限和文档有效性：

  device_db.get('你的目标文档ID').then(doc => {
    remote_db.put(doc).then(res => {
      console.log("单文档推送成功：", res);
    }).catch(err => {
      console.error("单文档推送失败：", err);
    });
  });
  

• 检查远程库权限：虽然你能从远程拉取数据，但推送需要写入权限。确认API_KEY对应的CouchDB用户，是否拥有该远程库的写入权限（在CouchDB的数据库权限设置中，成员角色需包含写入权限）。

3. Ionic正常、React Native异常的可能原因 #

PouchDB在React Native和Web（Ionic基于浏览器环境）的实现有核心差异，导致同步行为不同：

• 本地存储引擎差异：React Native用pouchdb-react-native依赖的是react-native-sqlite-storage或AsyncStorage，而Ionic用的是浏览器的IndexedDB。可能你在RN中保存文档的异步操作未正确完成，导致文档未真正写入本地库。
• 网络请求实现差异：RN的XMLHttpRequest和浏览器环境有区别，虽然你设置了超时，但可能存在隐性的请求头或连接问题。可以查看CouchDB服务器的访问日志，确认同步请求是否到达，以及服务器的具体响应。
• 版本兼容性问题：pouchdb-react-native的版本和你Ionic中使用的PouchDB版本是否一致？不同版本的复制逻辑可能有差异，比如新版本对文档校验更严格，导致旧代码在RN中无法正常工作。

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