无法通过Node.js代理实现CouchDB与PouchDB的同步

我之前帮不少人排查过PouchDB + CouchDB代理同步的问题，你遇到的ETIMEDOUT大概率是以下几个原因导致的，咱们一步步来解决：

1. 未处理CouchDB的分块响应与长连接 #

CouchDB的_changes接口（PouchDB同步的核心依赖）会用**分块传输编码（Chunked Transfer Encoding）**来实时推送更新，而node-http-proxy默认配置可能没有正确转发这类响应，导致前端连接长时间等待后超时。

解决方法：在代理配置中补充关键参数：

proxy.web(req, res, {
  target: 'http://127.0.0.1:5984',
  changeOrigin: true, // 修正请求Host头部，匹配CouchDB的预期
  timeout: 60000, // 延长超时时间到60秒，适配同步请求的耗时
  preserveHeaderKeyCase: true // 保留原始头部大小写，避免CouchDB解析异常
});

2. 缺失CORS头部处理 #

如果前端应用和代理服务器不在同一域名下，PouchDB发起的同步请求会先发送OPTIONS预检请求，若代理没有正确处理CORS头部，会导致后续请求被浏览器拦截，最终表现为超时。

可以在Express中添加CORS中间件：

app.use((req, res, next) => {
  // 生产环境请替换为具体的前端域名，不要用*
  res.header('Access-Control-Allow-Origin', '*');
  res.header('Access-Control-Allow-Methods', 'GET, POST, PUT, DELETE, OPTIONS');
  res.header('Access-Control-Allow-Headers', 'Authorization, Content-Type, Accept');
  
  if (req.method === 'OPTIONS') {
    return res.sendStatus(200); // 快速响应预检请求
  }
  next();
});

3. 未捕获代理错误 #

node-http-proxy的错误如果没有被捕获，会直接中断连接，导致前端收到超时错误。建议添加错误监听：

proxy.on('error', (err, req, res) => {
  console.error('Proxy Error:', err);
  res.writeHead(500, { 'Content-Type': 'application/json' });
  res.end(JSON.stringify({ error: 'Proxy server error', details: err.message }));
});

4. Express自身超时限制 #

Express默认有请求超时设置，如果同步请求耗时较长，会被Express主动断开。可以禁用或延长这个超时：

app.timeout = 0; // 禁用超时，生产环境可设置为合理最大值（比如300000毫秒=5分钟）

调试建议 #

你可以先用curl测试代理后的CouchDB接口，验证代理是否正常工作：

curl http://localhost:你的代理端口/你的数据库名/_changes?feed=continuous

如果这个命令能持续输出变更日志，说明代理已经正确转发了分块响应，再回到前端测试同步应该就能正常工作了。

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