基于await的Mongoose密码重置：updateOne回调中doc.password为undefined问题

核心问题根源 #

UserModel.updateOne() 回调的第二个参数，并不是更新后的文档实体对象，而是MongoDB执行更新操作后返回的结果元信息集合，仅包含操作执行状态的统计字段，不会携带更新后的业务字段内容。
你可以试着在回调里直接打印整个doc对象，就能看到它的典型结构为：

• acknowledged：布尔值，表示MongoDB是否确认执行了本次操作
• matchedCount：数值，表示查询条件匹配到的文档总数
• modifiedCount：数值，表示实际被修改的文档总数
• upsertedId：若开启upsert配置，返回新插入文档的_id值
  整个对象不存在password这类业务字段，因此读取doc.password自然会得到undefined。

认知偏差来源 #

很多开发者会混淆Mongoose不同更新方法的返回值逻辑：

• 调用文档实例的保存方法（比如user.save()），返回的是文档实体本身，可以正常读取业务字段
• 集合级的updateOne、updateMany方法，设计目标是轻量化执行更新指令，不额外做“查询-修改-回传完整文档”的开销，因此不会返回更新后的文档内容
  你观察到的“数据库字段确实更新、接口返回成功”的现象完全符合方法的设计逻辑——这些操作本身是正常执行的，只是对回调返回值的结构存在误解。

推荐实现方案 #

既然代码已经引入了async/await语法，推荐统一异步处理风格，换成能返回更新后文档的findOneAndUpdate方法，避免额外的数据库查询开销，同时补上异常处理逻辑：

exports.reset = async function (req, res) {
  try {
    const _id = req.body._id;
    const hashedPwd = await hash("123456");
    // 配置new: true，让方法返回更新完成后的文档实体（默认返回更新前的旧文档）
    const updatedUser = await UserModel.findOneAndUpdate(
      { _id: _id },
      { $set: { password: hashedPwd } },
      { new: true }
    );
    // 现在可以正常读取更新后的password字段
    console.log("updated password value:", updatedUser.password);
    res.send({ msg: "update success", code: "1" });
  } catch (err) {
    console.log("reset pwd error:", err);
    res.status(500).send({ msg: "update failed", code: "0" });
  }
};

如果坚持使用updateOne，不要尝试从它的返回值里读业务字段，需要更新操作执行完成后，单独调用一次查询拉取对应用户文档才能拿到字段值，这种方式会多一次数据库交互，通常不推荐。

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