Tips for JSON Schema ValidationJSON架构验证提示

_id Field and 字段和additionalProperties: false

When you specify additionalProperties: false in your JSON schema, MongoDB rejects documents that contain fields not included in your schema's properties object.当您在JSON模式中指定additionalProperties: false时，MongoDB将拒绝包含模式properties对象中未包含的字段的文档。

Because all objects contain an automatically-generated _id field, when you set additionalProperties: false, you must include the _id field in your properties object. 因为所有对象都包含自动生成的_id字段，所以当设置additionalProperties: false时，必须在properties对象中包含_id字段。If you don't, all documents are rejected.如果不这样做，所有文档都将被拒绝。

For example, with this validation, no documents are valid:例如，通过此验证，没有文档是有效的：

{
  "$jsonSchema": {
    "required": [ "_id", "storeLocation" ],
    "properties": {
      "storeLocation": { "bsonType": "string" }
    },
    "additionalProperties": false
  }
}

This validation ensures that storeLocation is a string. 此验证确保storeLocation是字符串。However, the properties object does not contain an _id field.但是，properties对象不包含_id字段。

To allow documents in the collection, you must update the properties object to include an _id field:要允许集合中的文档，必须更新properties对象以包含_id字段：

{
  "$jsonSchema": {
    "required": [ "_id", "storeLocation" ],
    "properties": {
      "_id": { "bsonType": "objectId" },
      "storeLocation": { "bsonType": "string" }
    },
    "additionalProperties": false
  }
}

Validation for null Field Valuesnull字段值的验证

Your application may be configured to set missing field values to null, instead of not including those fields in the object sent to the collection.您的应用程序可能被配置为将缺少的字段值设置为null，而不是在发送到集合的对象中不包括这些字段。

If your schema validates data types for a field, to insert documents with a null value for that field, you must explicitly allow null as a valid BSON type.如果您的架构验证了某个字段的数据类型，则要插入该字段具有null值的文档，必须明确允许null值作为有效的BSON类型。

For example, this schema validation does not allow documents where storeLocation is null:例如，此架构验证不允许storeLocation为null的文档：

db.createCollection("sales",
   {
      validator:
         {
            "$jsonSchema": {
               "properties": {
                  "storeLocation": { "bsonType": "string" }
               }
            }
         }
    }
 )

With the preceding validation, this document is rejected:通过上述验证，本文件被拒绝：

db.store.insertOne( { storeLocation: null } )

Alternatively, this schema validation allows null values for storeLocation:或者，此架构验证允许storeLocation为null值：

db.createCollection("store",
   {
      validator:
         {
            "$jsonSchema": {
               "properties": {
                  "storeLocation": { "bsonType": [ "null", "string" ] }
               }
            }
         }
    }
 )

With the preceding validation, this document is allowed:通过前面的验证，允许使用此文档：

db.store.insertOne( { storeLocation: null } )