MongoDB 中的 schema 验证如何工作？

Question

Accepted Answer

虽然 MongoDB 默认灵活，但它在数据库级别支持 **schema 验证** — 定义规则（必需字段、类型、值约束）来约束文档。这在 MongoDB 本身中添加数据完整性（不仅在应用代码中），平衡灵活性和一致性。

## 定义验证规则

```js
// add a JSON Schema validator when creating (or modifying) a collection
db.createCollection("users", {
  validator: {
    $jsonSchema: {
      bsonType: "object",
      required: ["name", "email"],            // required fields
      properties: {
        name: { bsonType: "string" },
        email: { bsonType: "string", pattern: "^.+@.+$" },   // type + pattern
        age: { bsonType: "int", minimum: 0, maximum: 120 }   // range
      }
    }
  }
});
// → documents that don't satisfy this are REJECTED on insert/update
```

MongoDB 使用 **JSON Schema** 来定义验证规则 — 必需字段、类型、模式、范围 — 在插入或更新文档时由数据库强制执行。

## 验证级别和操作

```js
db.runCommand({
  collMod: "users",
  validator: { $jsonSchema: { ... } },
  validationLevel: "moderate",     // "strict" (all) or "moderate" (only valid existing docs)
  validationAction: "error"        // "error" (reject) or "warn" (log but allow)
});
```

`validationLevel` 控制检查哪些文档；`validationAction` 控制违规是拒绝还是仅警告。

## 为什么在数据库中验证（而不仅在应用中）？

```text
✓ DATABASE-LEVEL guarantee — enforced regardless of which app/code writes data
  (multiple services, scripts, manual changes) → consistent data integrity
✓ A safety net even if application validation is bypassed or buggy
→ Similar reasoning to SQL constraints: the DB is the last line of defense for integrity.
```

## 平衡灵活性和结构

```text
MongoDB's flexibility is valuable, but UNCONTROLLED flexibility → inconsistent data.
Schema validation lets you add structure WHERE you need it:
  → enforce critical fields/types while keeping flexibility elsewhere
  → start flexible, add validation as the schema stabilizes
(Often validation is also/instead done in the app layer, e.g. via Mongoose schemas.)
```

## 为什么这很重要

理解 MongoDB schema 验证对于**将 MongoDB 的灵活性与数据完整性相平衡**很有价值，因此它是构建可靠的 MongoDB 应用程序的有用知识。

虽然 MongoDB 的无 schema 灵活性是一个主要优势（适合不断演变和多样化的数据），但**不受控的灵活性会导致数据不一致**（缺少字段、类型错误、无效值）— 这是数据质量的真实问题。

Schema 验证通过让你强制执行规则（通过 JSON Schema 的必需字段、类型、模式、范围）**在数据库级别**来解决这个问题，使文档必须满足这些规则。

**数据库级验证**（相对于仅应用级验证）的关键价值在于它被强制执行，无论哪个应用程序、服务、脚本或手动操作写入数据 — 提供一致的完整性保证和一个安全网，即使应用程序验证被绕过或有 bug（与 SQL 约束的原理相同：数据库作为最后一道防线）。

理解**验证级别和操作**（控制检查哪些文档以及违规是拒绝还是警告）允许灵活采用。

最重要的是，理解如何**平衡灵活性和结构** — 在需要一致性的地方添加验证，在其他地方保持灵活性，通常从灵活开始，随着 schema 稳定而添加验证 — 反映了成熟的 MongoDB 使用方式，获得灵活性的好处而不牺牲关键数据完整性。

了解验证通常也在应用层完成（例如 Mongoose schemas）也很相关。

由于数据完整性即使在灵活数据库中也很重要，并且由于 MongoDB 的 schema 验证让你在需要的地方强制执行结构（在数据库级别提供强有力的保证）同时保留灵活性，理解 schema 验证 — 它如何工作、数据库级强制执行的好处，以及平衡灵活性和结构 — 是构建维护数据质量的 MongoDB 应用程序的宝贵、实际相关的知识，是一项有用的能力，解决了灵活 schema 数据库中数据不一致的常见问题。