Mongoose Schema中数组字段required验证不生效问题

架构老林

2026-5-26

解决Mongoose数组类型required: true验证不生效的问题

这个问题我之前踩过坑，Mongoose对数组字段的required验证逻辑确实和普通类型不一样，咱们一步步来捋清楚：

问题原因

当你在Schema中定义数组类型字段时，Mongoose有个默认行为：如果创建文档时没有显式提供该字段的值，它会自动把这个字段初始化为空数组[]。而required: true的验证规则只是检查字段是否存在（即不是null或undefined），空数组显然是“存在”的，所以验证就直接通过了——这就是为什么你省略outputs时没触发错误，但address（字符串类型，没有默认初始化）会正常抛出必填错误。

解决方案

根据你的需求（字段必须始终非null且非undefined），有两种对应方案：

方案1：允许空数组，但禁止`null/undefined`

只需要给数组字段设置default: undefined，覆盖Mongoose默认的空数组初始化行为：

const nodeSchema = new Schema({
  address: { type: String, required: true },
  outputs: { type: [String], required: true, default: undefined }
});

这样当你创建文档时省略outputs，它的值会是undefined，刚好触发required: true的验证错误。

方案2：既禁止`null/undefined`，也禁止空数组

如果你的需求还包括数组不能是空的，那就需要加上自定义验证器：

const nodeSchema = new Schema({
  address: { type: String, required: true },
  outputs: {
    type: [String],
    required: true,
    validate: {
      validator: function(value) {
        // 确保数组存在且长度大于0
        return Array.isArray(value) && value.length > 0;
      },
      message: 'outputs必须是一个非空数组'
    }
  }
});

这个方案下，不管是省略字段（Mongoose初始化为空数组，被自定义验证拦截），还是主动传空数组，都会触发验证错误。