如何从HTML表单向Mongoose Schema传递数组对象

我需要通过HTML表单在MongoDB中创建匹配指定Mongoose Schema的教师评价文档，其中notes是包含评价对象的数组。尝试用notes[0].author和notes[0][author]命名表单字段传递数据，要么notes为空数组，要么触发ValidationError，提示无法将字符串转换为嵌入式文档。

浏览器输入内容：

• name: mathis
• familyName: de sousa
• author: mathis de sousa

表单代码：

<form action="/teachers" method="post">
    <input type="text" placeholder="name" name="name" required>
    <input type="text" placeholder="familyName" name="familyName" required>
    <input type="text" name="notes[0].author">
    <input type="number" name="notes[0].knowledge">
    <input type="number" name="notes[0].helpfulness">
    <input type="number" name="notes[0].attitude">
    <input type="number" name="notes[0].overallRating">
    <input type="text" name="notes[0].comment">
    <button>Submit</button>
</form>

Mongoose Schema：

const teacherSchema = new mongoose.Schema({
    name: {
        type: String,
        required: true
    },
    familyName: {
        type: String,
        required: true
    },
    notes: [
    {   
        author: {
            type: String,
            required: true
        },
        knowledge: {
            type: Number,
            required: true,
            min:0,
            max:10
        },
        helpfulness: {
            type: Number,
            required: true,
            min:0,
            max:10
        },
        attitude: {
            type: Number,
            required: true,
            min:0,
            max:10
        },
        overallRating: {
            type: Number,
            required: true,
            min:0,
            max:10
        },
        comment: {
            type: String,
            required: false
        }
    }]
});

错误信息：

C:\Users\hddes\Desktop\js-udemy\ESUPcamp\node_modules\mongoose\lib\document.js:3197
    this.$__.validationError = new ValidationError(this);
                               ^

ValidationError: Teachers validation failed: notes: Cast to embedded failed for value "Mathis DE SOUSA" (type string) at path "notes" because of "ObjectParameterError"
    at Document.invalidate (C:\Users\hddes\Desktop\js-udemy\ESUPcamp\node_modules\mongoose\lib\document.js:3197:32)
    at model.$set (C:\Users\hddes\Desktop\js-udemy\ESUPcamp\node_modules\mongoose\lib\document.js:1456:12)
    at model.$set (C:\Users\hddes\Desktop\js-udemy\ESUPcamp\node_modules\mongoose\lib\document.js:1111:16)
    at model.Document (C:\Users\hddes\Desktop\js-udemy\ESUPcamp\node_modules\mongoose\lib\document.js:166:12)
    at model.Model (C:\Users\hddes\Desktop\js-udemy\ESUPcamp\node_modules\mongoose\lib\model.js:130:12)
    at new model (C:\Users\hddes\Desktop\js-udemy\ESUPcamp\node_modules\mongoose\lib\model.js:4770:15)
    at C:\Users\hddes\Desktop\js-udemy\ESUPcamp\index.js:55:24
    at Layer.handle [as handle_request] (C:\Users\hddes\node_modules\express\lib\router\layer.js:95:5)
    at next (C:\Users\hddes\node_modules\express\lib\router\route.js:144:13)
    at Route.dispatch (C:\Users\hddes\node_modules\express\lib\router\route.js:114:3) {
  errors: {
    notes: CastError: Cast to embedded failed for value "Mathis DE SOUSA" (type string) at path "notes" because of "ObjectParameterError"
        at SchemaDocumentArray.cast (C:\Users\hddes\Desktop\js-udemy\ESUPcamp\node_modules\mongoose\lib\schema\documentArray.js:508:19)
        at SchemaType.applySetters (C:\Users\hddes\Desktop\js-udemy\ESUPcamp\node_modules\mongoose\lib\schemaType.js:1221:12)
        at model.$set (C:\Users\hddes\Desktop\js-udemy\ESUPcamp\node_modules\mongoose\lib\document.js:1414:22)
        at model.$set (C:\Users\hddes\Desktop\js-udemy\ESUPcamp\node_modules\mongoose\lib\document.js:1111:16)
        at model.Document (C:\Users\hddes\Desktop\js-udemy\ESUPcamp\node_modules\mongoose\lib\document.js:166:12)
        at model.Model (C:\Users\hddes\Desktop\js-udemy\ESUPcamp\node_modules\mongoose\lib\model.js:130:12)
        at new model (C:\Users\hddes\Desktop\js-udemy\ESUPcamp\node_modules\mongoose\lib\model.js:4770:15)
        at C:\Users\hddes\Desktop\js-udemy\ESUPcamp\index.js:55:24
        at Layer.handle [as handle_request] (C:\Users\hddes\node_modules\express\lib\router\layer.js:95:5)
        at next (C:\Users\hddes\node_modules\express\lib\router\route.js:144:13) {
      stringValue: '"Mathis DE SOUSA"',
      messageFormat: undefined,
      kind: 'embedded',
      value: 'Mathis DE SOUSA',
      path: 'notes',
      reason: ObjectParameterError: Parameter "obj" to Document() must be an object, got "Mathis DE SOUSA" (type string)
          at EmbeddedDocument.Document (C:\Users\hddes\Desktop\js-udemy\ESUPcamp\node_modules\mongoose\lib\document.js:113:11)
          at EmbeddedDocument.Subdocument (C:\Users\hddes\Desktop\js-udemy\ESUPcamp\node_modules\mongoose\lib\types\subdocument.js:34:12)
          at EmbeddedDocument.ArraySubdocument [as constructor] (C:\Users\hddes\Desktop\js-udemy\ESUPcamp\node_modules\mongoose\lib\types\arraySubdocument.js:44:15)
          at new EmbeddedDocument (C:\Users\hddes\Desktop\js-udemy\ESUPcamp\node_modules\mongoose\lib\schema\documentArray.js:127:17)
          at SchemaDocumentArray.cast (C:\Users\hddes\Desktop\js-udemy\ESUPcamp\node_modules\mongoose\lib\schema\documentArray.js:502:22)
          at SchemaType.applySetters (C:\Users\hddes\Desktop\js-udemy\ESUPcamp\node_modules\mongoose\lib\schemaType.js:1221:12)
          at model.$set (C:\Users\hddes\Desktop\js-udemy\ESUPcamp\node_modules\mongoose\lib\document.js:1414:22)
          at model.$set (C:\Users\hddes\Desktop\js-udemy\ESUPcamp\node_modules\mongoose\lib\document.js:1111:16)
          at model.Document (C:\Users\hddes\Desktop\js-udemy\ESUPcamp\node_modules\mongoose\lib\document.js:166:12)
          at model.Model (C:\Users\hddes\Desktop\js-udemy\ESUPcamp\node_modules\mongoose\lib\model.js:130:12),
      valueType: 'string'
    }
  },
  _message: 'Teachers validation failed'
}

问题根源 #

错误提示说明notes字段被传入了字符串值，但Mongoose期望的是包含嵌入式文档的数组。核心原因是Express默认不解析嵌套格式的表单数据，导致notes[0].author这类字段没有被正确解析为嵌套对象数组。

步骤1：开启Express的嵌套参数解析 #

在Express入口文件中添加express.urlencoded中间件，并设置extended: true，这样才能解析嵌套结构的表单参数：

app.use(express.urlencoded({ extended: true }));

extended: true允许解析复杂嵌套对象，而非仅支持扁平键值对。

步骤2：确保表单必填字段完整 #

你的表单字段命名notes[0].author是正确的，但要注意Schema中author、knowledge、helpfulness等都是必填项，必须全部填写。如果只填author，其他必填项为空，也会触发验证错误。

步骤3：后端正确处理请求体 #

解析完成后，req.body会自动包含正确的嵌套结构，直接用它创建文档即可：

router.post('/teachers', async (req, res) => {
  try {
    const teacher = new Teacher(req.body);
    await teacher.save();
    res.redirect('/teachers');
  } catch (err) {
    console.error(err);
    res.status(400).send('验证失败，请检查输入');
  }
});

解析后的req.body结构示例：

{
  name: 'mathis',
  familyName: 'de sousa',
  notes: [
    {
      author: 'mathis de sousa',
      knowledge: 8,
      helpfulness: 9,
      attitude: 7,
      overallRating: 8,
      comment: '不错的老师'
    }
  ]
}

步骤4：优化Schema结构（可选） #

把嵌套的评价Schema抽离出来，代码更清晰易维护：

const noteSchema = new mongoose.Schema({
  author: { type: String, required: true },
  knowledge: { type: Number, required: true, min:0, max:10 },
  helpfulness: { type: Number, required: true, min:0, max:10 },
  attitude: { type: Number, required: true, min:0, max:10 },
  overallRating: { type: Number, required: true, min:0, max:10 },
  comment: { type: String }
});

const teacherSchema = new mongoose.Schema({
  name: { type: String, required: true },
  familyName: { type: String, required: true },
  notes: [noteSchema]
});

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