如何根据场景控制Mongoose子文档的必填性与校验规则？

这个需求其实挺常见的，我给你两种实用的解决方案，你可以根据自己的场景选择：

方案一：创建可配置的Address Schema生成函数 #

这种方法最灵活，通过一个函数来生成不同校验规则的Address Schema，完美适配你的两种场景：

// address.js
const mongoose = require('mongoose');

// 传入isRequired参数，控制内部字段是否必填
module.exports = (isRequired = false) => {
  // 定义必填规则：如果isRequired为true，就设置必填并给出提示，否则设为非必填
  const requiredRule = isRequired ? [true, 'This field is required'] : false;
  
  return mongoose.Schema({
    town: { type: String, required: requiredRule },
    index: {
      type: String,
      required: requiredRule,
      validate: {
        validator: function (v) {
          // 非必填场景下，如果字段为空，直接通过校验；否则检查格式
          if (!v && !isRequired) return true;
          return /^\d+$/.test(v);
        },
        message: 'Invalid index'
      }
    },
    district: { type: String, required: requiredRule },
    street: { type: String, required: requiredRule },
    house: { type: String, required: requiredRule },
    apartment: String // 始终非必填
  });
};

然后在User模型中，我们传入true来生成内部字段必填的Address Schema，同时把address字段本身设为必填：

// user.js
const createAddressSchema = require('./address');
const mongoose = require('mongoose');

const userSchema = mongoose.Schema({
  address: { 
    type: createAddressSchema(true), 
    required: [true, 'Address is required'] 
  }
});

module.exports = mongoose.model('User', userSchema);

在Other模型中，传入false生成内部字段非必填的版本，address字段本身也设为非必填：

// other.js
const createAddressSchema = require('./address');
const mongoose = require('mongoose');

const otherSchema = mongoose.Schema({
  address: createAddressSchema(false)
});

module.exports = mongoose.model('Other', otherSchema);

这种方法的好处是完全复用了Address的核心逻辑，只通过参数切换校验规则，后期维护起来也方便。

方案二：在父Schema中添加自定义校验器 #

如果你不想修改现有的Address Schema，也可以在父模型的address字段上添加自定义校验器，针对性地控制校验逻辑：

首先保持原有的Address Schema不变，然后在User模型中添加自定义校验，确保address必填且内部关键字段都不为空：

// user.js
const Address = require('./address');
const mongoose = require('mongoose');

const userSchema = mongoose.Schema({
  address: { 
    type: Address, 
    required: [true, 'Address is required'],
    validate: {
      validator: function(address) {
        // 检查除apartment外的所有字段是否都有有效值
        const requiredFields = ['town', 'index', 'district', 'street', 'house'];
        return requiredFields.every(field => {
          const value = address[field];
          return value && value.trim() !== '';
        });
      },
      message: 'Address must include town, index, district, street and house'
    }
  }
});

module.exports = mongoose.model('User', userSchema);

而Other模型就保持你原来的写法即可：

// other.js
const Address = require('./address');
const mongoose = require('mongoose');

const otherSchema = mongoose.Schema({
  address: Address
});

module.exports = mongoose.model('Other', otherSchema);

这里要注意：Mongoose默认只有当字段存在且有值时，才会触发它的校验器。所以在Other模型中，如果address为空，不会触发任何校验；如果填了address，index字段如果有值才会检查格式，没值也不会报错，正好符合你的需求。

总结 #

• 如果你需要在多个场景复用不同规则的Address，优先选方案一，扩展性更强；
• 如果只是临时针对User模型做特殊校验，方案二更简单，不需要修改原有的Schema。

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