MongoDB调用replaceOne替换文档后线上数据未更新如何排查

我当前使用的MongoDB数据库中，每个文档初始包含5个字段项，点此查看示例。
我希望为数据库内的文档新增更多字段与信息，目前通过如下代码实现相关逻辑：

NFT.findOne({ "name": name }, (err, value) => {
    if (err) { console.error(err) }
    if (!value) {
        console.log('no value')
        let newNFT = new NFT({name, slug, symbol, description, verifiedStatus, bannerUrl, logoUrl, floorPrice, stats, social})
        newNFT.save() 
    } 
    else {
        let newNFT = new NFT({name, slug, symbol, description, verifiedStatus, bannerUrl, logoUrl, floorPrice, stats, social})
        NFT.replaceOne({"name": name}, newNFT, {returnDocument: "after"})
    }
})

执行console.log(NFT.find({"name": name}))可返回包含所有字段的对象，但线上数据库中的数据并未实际更新。已确认数据库连接正常（可正常拉取线上库数据），但更新操作始终不生效。

你的代码有三个核心问题导致更新不生效：

• 异步操作未等待：save()和replaceOne()都是异步方法，你既没有传回调函数接收执行结果，也没有用await等待操作执行完成，代码运行到这一步时数据库请求还没真正发送，逻辑就已经走完了，自然不会有数据落库。
• 本地缓存误导判断：你通过new NFT()创建的模型实例会被Mongoose暂存在本地内存缓存中，此时调用NFT.find()会把这份未持久化的本地数据和数据库返回结果合并返回，所以你能在控制台看到全字段对象，但这部分数据根本没写到线上库里。
• 替换参数格式错误：你传给replaceOne()的是Mongoose Document实例，不是普通JS对象，实例自带的_id字段和库中原文档的_id不匹配时，会触发_id唯一索引冲突，又因为你没写错误捕获，这个失败会被静默吞掉。

不需要先调用findOne判断文档是否存在，直接用replaceOne加upsert: true选项一步完成「存在则替换、不存在则新建」的逻辑，全程使用async/await等待异步执行、捕获错误即可：

// 封装成异步函数
async function syncNFTData(nftFields) {
  const { name, slug, symbol, description, verifiedStatus, bannerUrl, logoUrl, floorPrice, stats, social } = nftFields;
  try {
    const res = await NFT.replaceOne(
      { name: name },
      // 直接传普通对象作为替换内容，不要传new NFT()生成的实例
      { name, slug, symbol, description, verifiedStatus, bannerUrl, logoUrl, floorPrice, stats, social },
      {
        upsert: true, // 匹配不到文档时自动新建
        returnDocument: "after"
      }
    );
    console.log('数据同步完成', res);
  } catch (err) {
    console.error('数据同步失败', err);
  }
}

// 调用函数执行同步
syncNFTData({name, slug, symbol, description, verifiedStatus, bannerUrl, logoUrl, floorPrice, stats, social});

如果要保留原有先查再写的逻辑，必须给save()和replaceOne()都加上await和错误捕获，传给replaceOne的Document实例要先调用.toObject()转成普通对象，去掉自动生成的无关_id字段，避免唯一键冲突。

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