CouchDB无法插入大文档 报document_too_large错误如何解决

使用Node.js结合ActiveMQ实现CouchDB文档上传逻辑时，小体积文档可正常上传，上传30MB大小文档时操作失败，抛出document_too_large异常，完整错误信息如下：

(node:28) UnhandledPromiseRejectionWarning: Error: document_too_large
    at Request._callback (/app/node_modules/**/multitenant/node_modules/nano/lib/nano.js:151:15)
    at Request.self.callback (/app/node_modules/request/request.js:185:22)
    at emitTwo (events.js:126:13)
    at Request.emit (events.js:214:7)
    at Request.<anonymous> (/app/node_modules/request/request.js:1154:10)
    at emitOne (events.js:116:13)
    at Request.emit (events.js:211:7)
    at IncomingMessage.<anonymous> (/app/node_modules/request/request.js:1076:12)
    at Object.onceWrapper (events.js:313:30)
    at emitNone (events.js:111:20)
    at IncomingMessage.emit (events.js:208:7)
    at endReadableNT (_stream_readable.js:1064:12)
    at _combinedTickCallback (internal/process/next_tick.js:138:11)
    at process._tickCallback (internal/process/next_tick.js:180:9)
(node:28) UnhandledPromiseRejectionWarning: Unhandled promise rejection. This error originated either by throwing inside of an async function without a catch block, or by rejecting a promise which was not handled with .catch(). (rejection id: 1)
(node:28) [DEP0018] DeprecationWarning: Unhandled promise rejections are deprecated. In the future, promise rejections that are not handled will terminate the Node.js process with a non-zero exit code.

• 核心报错原因：触发了CouchDB的单文档大小限制。CouchDB通过max_document_size配置项限制单文档的最大体积，默认值通常为1MB~8MB（随版本不同有差异），30MB的文档远超默认阈值，因此被服务端直接拒绝。从错误栈的multitenant路径判断，当前使用的是多租户模式部署的CouchDB，还可能存在租户级别单独配置的文档大小限制。
• 附带的UnhandledPromiseRejectionWarning警告是因为Node.js侧调用nano客户端插入文档的异步逻辑没有添加异常捕获，不是导致插入失败的根因，但该问题会导致未来Node.js版本下进程直接异常退出。

• 调整CouchDB文档大小上限：
  1. 找到CouchDB配置文件local.ini，在[couchdb]配置段下添加或修改配置项max_document_size = 33554432（配置单位为字节，33554432对应32MB，可根据业务实际需求调整为更大值，不建议设置为0即无限制，避免极端大文档拖垮服务）。
  2. 如果是多租户模式部署，需要同步检查租户级别的配置，确保租户侧的文档大小限制不小于需要上传的文档体积。
  3. 配置修改完成后重启CouchDB服务即可生效。
• 补全Node.js侧异常捕获：所有调用nano执行文档操作的异步逻辑，都需要通过try/catch（async/await场景）或者.catch()（Promise场景）捕获异常，避免未处理的Promise reject触发进程退出风险，示例：

// async/await 写法的异常捕获示例
async function uploadDoc(docContent) {
  try {
    const insertRes = await db.insert(docContent)
    // 插入成功后的业务逻辑
    return insertRes
  } catch (err) {
    console.error('文档插入失败：', err.message)
    // 失败重试、错误返回等逻辑
    throw err
  }
}

• 大文件存储优化：如果业务中经常需要存储超过10MB的大体积内容，不建议直接将内容作为普通文档字段存入CouchDB，优先选择两种方案：一是使用CouchDB自带的附件功能存储大体积内容；二是将大文件存储到专用对象存储服务，CouchDB文档中仅存储文件的访问地址、元信息，降低CouchDB的读写、同步、索引压力，避免大文档引发的性能问题。

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