如何为MongoDB中的递归嵌套文档定义JSON Schema校验规则

MongoDB完全支持为递归结构文档定义JSON Schema校验规则，你可以通过$defs定义通用结构片段，再用$ref递归引用自身即可实现嵌套评论的校验需求，完整实现示例如下：

db.createCollection("posts", {
  validator: {
    $jsonSchema: {
      bsonType: "object",
      required: ["title", "content", "comments"],
      properties: {
        title: { bsonType: "string", maxLength: 200 },
        content: { bsonType: "string" },
        // 顶层评论数组校验规则
        comments: {
          bsonType: "array",
          items: { $ref: "#/$defs/commentItem" }
        }
      },
      // 定义可复用的单条评论结构片段
      $defs: {
        commentItem: {
          bsonType: "object",
          required: ["user", "message"],
          properties: {
            user: { bsonType: "string", description: "评论发布用户名/ID" },
            message: { bsonType: "string", description: "评论内容" },
            // 子评论直接递归引用当前commentItem结构
            comments: {
              bsonType: "array",
              items: { $ref: "#/$defs/commentItem" },
              default: []
            }
          },
          additionalProperties: false
        }
      }
    }
  }
})

核心实现逻辑 #

• 先在$defs字段中定义单条评论的通用校验规则commentItem，包含必填的user、message字段，以及可选的子评论数组字段comments
• 子评论数组的items属性通过$ref: "#/$defs/commentItem"引用自身的结构，无论嵌套多少层，都会复用同一套校验规则
• 可通过additionalProperties: false限制评论中只能出现预定义的字段，避免脏数据写入

注意事项 #

• 如果你使用的是MongoDB 3.6~5.0的旧版本，对$defs支持不完善时，可以将$defs替换为旧版关键字definitions，对应的引用路径同步修改为#/definitions/commentItem即可正常使用
• 可以为comments数组添加maxItems限制，避免单条评论下的回复数量过多影响读写性能
• 如需限制嵌套深度，可在业务层做层数控制，或者配合JSON Schema的自定义校验逻辑实现，避免无限递归导致的查询性能问题

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