PouchDB向远程CouchDB同步变更遇ETIMEDOUT（含中间代理）问题咨询

这问题我之前帮不少开发者排查过，核心矛盾点在于你的Node.js代理层默认的超时限制和长连接心跳的传递问题——毕竟非live模式的短连接一切正常，说明基础数据通路没问题，只有长连接的live changes才会触发超时，咱们一步步来解决：

1. 先修复Node.js代理（express-http-proxy）的配置 #

express-http-proxy默认会给请求设置超时时间（一般是30秒左右），而live changes是长连接，代理会主动断开这个空闲连接，导致客户端收到ETIMEDOUT错误。你需要调整代理的超时和长连接相关配置：

const proxy = require('express-http-proxy');

app.use('/couchdb', proxy('https://你的CouchDB地址', {
  // 取消代理自身的超时限制，让长连接能一直保持
  timeout: 0,
  // 装饰代理请求的选项，强制开启长连接
  proxyReqOptDecorator: function(proxyReqOpts, originalReq) {
    proxyReqOpts.headers['Connection'] = 'keep-alive';
    // 给Keep-Alive头设置足够长的超时，避免中间网络设备断开
    proxyReqOpts.headers['Keep-Alive'] = 'timeout=600, max=1000';
    return proxyReqOpts;
  },
  // 确保不修改CouchDB返回的响应头（比如Transfer-Encoding），否则会破坏长连接
  proxyResDecorator: function(proxyRes) {
    return proxyRes;
  }
}));

2. 优化PouchDB Changes的参数配置 #

你的心跳设置得太频繁（1000ms），反而可能导致代理或CouchDB的异常，同时需要明确禁用PouchDB的主动超时：

// 把监听逻辑封装成函数，方便出错后重连
let changesListener;
function setupLiveUserChanges(userDocId) {
  // 先销毁之前的监听，避免内存泄漏
  if (changesListener) {
    changesListener.cancel();
  }

  changesListener = db.changes({
    since: 'now',
    live: true,
    include_docs: true,
    doc_ids: [userDocId],
    heartbeat: 25000, // 设为25秒，比大多数网络设备的30秒超时短一点
    timeout: false, // 禁止PouchDB主动终止请求
    requestTimeout: 0 // 部分PouchDB版本需要这个参数确保长连接不被中断
  })
  .on('change', function(change) {
    console.log("USER INFO change:", change);
  })
  .on('complete', function(info) {
    console.warn("USER INFO complete:", info);
    // 连接意外完成时自动重连
    setTimeout(() => setupLiveUserChanges(userDocId), 3000);
  })
  .on('error', function(err) {
    console.error("USER INFO error:", err);
    // 出错后延迟重连，避免频繁请求
    setTimeout(() => setupLiveUserChanges(userDocId), 5000);
  });
}

// 初始化监听
setupLiveUserChanges(userDocId);

3. 检查CouchDB的服务器配置 #

确保CouchDB允许长连接和足够的超时时间，修改local.ini配置文件：

[httpd]
timeout = 3600000 ; 设置为1小时，足够支撑长连接

CouchDB默认的heartbeat机制是开启的，不需要额外修改，但如果你的CouchDB有自定义配置，要确认[changes]部分没有禁用心跳。

4. 排查网络中间件的限制 #

如果你的代理或CouchDB部署在云服务商（比如AWS、阿里云），要检查负载均衡器、防火墙的空闲连接超时设置——很多云服务默认30秒断开空闲连接，这时候把PouchDB的heartbeat设为25秒就能确保在断开前发送心跳包，维持连接。

总结一下：核心是让代理层不要主动断开长连接，同时让PouchDB和CouchDB的心跳协同工作，再加上重连机制，就能实现永久保持的实时变更连接了。

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