PouchDB传入含文档的变量调用put方法报412错误，如何解决？

数据老陈

2026-8-14

解决PouchDB put()方法"missing_id"错误：直接传入完整文档对象的正确方式

当然可以直接传入包含_id和_rev的完整文档对象到PouchDB的put()方法，你遇到的412错误完全是传参格式问题，和文档里的未知字段无关。

错误原因

你用{doc}的形式传参，本质是把原文档包在了一个额外的外层对象里。PouchDB会把这个外层对象当作要存储的新文档，而这个外层对象里并没有_id字段——这就是触发"missing_id"错误的核心原因。

正确用法示例

假设你已经从同步后的数据库里获取到了文档doc，修改了特定字段后，直接把doc变量传入put()即可：

// 修改文档的特定字段
doc.targetField = "新值";

// 直接传入完整文档对象（包含_id、_rev及所有字段）
db.put(doc)
  .then((response) => {
    // 成功更新后，记得把本地文档的_rev换成最新版本
    doc._rev = response.rev;
  })
  .catch((err) => {
    console.error("更新失败:", err);
  });

这样PouchDB会完整保留所有字段（包括你新增的未知字段），不需要手动逐个指定_id、_rev和其他字段，完全适配你的场景。