如何使用字段不固定的对象更新MongoDB的Mongoose文档

问题原因 #

你的写法存在两个核心问题导致更新不生效：

1. 没有指定MongoDB的更新操作符，直接传递{ data }相当于尝试给用户文档新增一个顶级字段data，而不是修改gameProfile下的嵌套字段
2. 嵌套字段的更新需要明确指定字段路径，不能直接传递子对象的键名，否则Mongoose找不到对应要更新的字段

解决方案 #

你需要先把传入的待更新字段加上gameProfile.前缀，再用$set操作符包裹后执行更新，同时建议开启字段校验避免不符合Schema规则的数据写入：

// 示例待更新数据
const data = { accountLevel: 50, accountClass: 'DPS', favoriteWeapon: 'sword' }

// 转换为嵌套字段的路径格式
const updateFields = {}
Object.keys(data).forEach(key => {
  updateFields[`gameProfile.${key}`] = data[key]
})

// 执行更新
User.updateOne(
  { userID: interaction.user.id },
  { $set: updateFields },
  { runValidators: true }, // 开启Schema校验，accountLevel超过65时会抛出错误
  (err, res) => {
    if (err) {
      console.error(err)
      // 此处可添加错误提示逻辑，比如返回给用户等级超出范围
      return
    }
    // matchedCount大于0说明找到了对应要更新的用户
    if (res.matchedCount === 0) {
      console.log('未找到对应用户')
      return
    }
    console.log('更新成功', res)
  }
)

如果你使用的是支持async/await的Node.js版本，更推荐用异步写法：

async function updateUserGameProfile(userId, data) {
  const updateFields = {}
  Object.keys(data).forEach(key => {
    updateFields[`gameProfile.${key}`] = data[key]
  })
  try {
    const res = await User.updateOne(
      { userID: userId },
      { $set: updateFields },
      { runValidators: true }
    )
    if (res.matchedCount === 0) {
      console.log('未找到对应用户')
      return
    }
    console.log('更新成功', res)
  } catch (err) {
    console.error('更新失败', err)
  }
}

// 调用方法
updateUserGameProfile(interaction.user.id, data)

额外说明 #

• 你Schema中定义了accountLevel的取值范围是1~65，如果用户传入100这类超出范围的值，开启runValidators后会直接抛出校验错误，你可以捕获该错误后给用户返回对应提示
• res.modifiedCount可以用来判断是否真的执行了字段修改，如果传入的值和数据库中已有值完全一致，这个字段会返回0

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