Mongoose调用findById报错：Path submitter.username is required问题咨询

我正在使用Node.js和MongoDB（Mongoose）搭建一个用户博客分享系统。最初的SubmittedBlog模型定义如下：

const SubmittedBlogSchema = new mongoose.Schema({
    blogType: {
        type: String,
        required: true
    },
    text: {
        type: String,
        required: [true, 'Please enter a text'],
        minlength: [50, 'Text must be at least 50 characters long'],
        maxlength: [2000, 'Text must be at most 2000 characters long'],
        trim: true
    },
    ...
});

之后我新增了必填的submitter对象字段，用于存储提交者信息，更新后的模型定义：

const SubmittedBlogSchema = new mongoose.Schema({
    blogType: {
        type: String,
        required: true
    },
    submitter: {
        id: {
            type: mongoose.Schema.Types.ObjectId,
            ref: "User",
            required: true
        },
        username: {
            type: String,
            required: true
        }
    },
    ...
});

现在调用SubmittedBlog.findById()时执行失败，报错提示Path submitter.username is required。我原本以为只有保存博客时才会触发必填校验，为什么查询操作也会出现这个错误？

原因分析 #

Mongoose默认会在查询返回文档时执行校验逻辑（包括find/findById这类查询操作）。如果你数据库里存在新增submitter字段前创建的旧博客数据，这些文档要么没有submitter字段，要么submitter下的id/username缺失，就会触发必填校验失败，导致查询报错。

解决办法 #

有几种可行的处理方式：

• 批量更新旧数据：直接在MongoDB中补全所有旧文档的submitter字段。比如用MongoDB Shell执行：

  db.submittedblogs.updateMany(
    { submitter: { $exists: false } },
    { $set: { submitter: { id: ObjectId("实际用户ID"), username: "实际用户名" } } }
  );
  

  注意替换成符合业务逻辑的有效用户ID和用户名，或者根据实际场景补充数据。

• 临时关闭查询校验：可以在Schema定义或单个查询中关闭校验，这是过渡方案不推荐长期使用：

  • 全局关闭Schema的查询校验：

    const SubmittedBlogSchema = new mongoose.Schema({
      // 字段定义...
    }, { runValidators: false });
    

  • 单个查询关闭校验：

    SubmittedBlog.findById(blogId, {}, { runValidators: false })
      .then(blog => { /* 业务处理逻辑 */ })
      .catch(err => { /* 错误处理 */ });
    

• 临时修改字段为可选：如果业务允许，可暂时将submitter及其子字段的required改为false，等旧数据全部更新完成后再改回必填。

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