CouchDB双节点集群下移动端PouchDB复制失败问题求助

核心问题定位 #

单节点正常、集群后复制失败的情况，基本和CouchDB集群的外部寻址配置、负载均衡的会话策略，或节点对外可达性相关，以下是针对性排查和修复步骤：

1. 修正CouchDB节点的external_url配置 #

CouchDB集群需要每个节点明确自己对外的可访问地址，否则会把内部IP返回给移动端，导致连接失败：

• 登录每个节点的CouchDB管理界面（/_utils/#/config），确认couchdb.external_url设置为负载均衡的域名/公网IP，而非Docker内部IP或EC2私有IP。
• Docker启动时可直接通过环境变量指定：

  docker run -e COUCHDB_EXTERNAL_URL="https://your-lb-domain:5984" ... couchdb:latest
  

2. 配置负载均衡的会话粘性 #

PouchDB与CouchDB的复制依赖持续会话，负载均衡随机分发请求会导致复制中断：

• 在AWS ALB中开启基于Cookie的会话保持，超时时间设置为30分钟以上（覆盖常规复制耗时）。
• 确认ALB目标组的健康检查规则正确，仅向健康节点转发流量。

3. 验证集群节点的外部可达性 #

EC2实例间同步正常不代表外部可访问：

• 检查EC2安全组，确保5984端口对移动端IP段（生产环境建议限制范围）开放。
• 直接访问每个节点的公网IP:5984，调用/_membership接口，确认返回的节点列表中，每个节点的hostname是外部可解析的地址。

4. 调整PouchDB复制配置 #

• 确保移动端复制代码使用负载均衡域名作为远程地址，而非单个EC2节点IP。
• 开启重试机制应对临时连接波动：

  PouchDB.replicate(localDB, 'https://your-lb-domain:5984/remote-db', {
    live: true,
    retry: true,
    heartbeat: 30000
  });
  

5. 查看日志定位具体错误 #

登录Docker容器查看CouchDB日志：

docker logs <couchdb-container-id>

重点关注复制请求的错误信息，比如401 Unauthorized（权限配置问题）、503 Service Unavailable（节点未正常加入集群）或地址解析失败日志。

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