MongoDB Schema验证错误：指定['string']类型插入数组触发类型不匹配

我用PyMongo编写代码，向MongoDB Atlas上的Customer集合插入数据，调用insert_many()插入以下文档：

{'Source': ['LoanDelivery_2022-03-31'], 'CustID': 1, 'CustName': 'Seexxx', 'CustPhone': '940xxxxx', '_id': ObjectId('66ca8d5873a3fdxxxx')}

集合的Schema定义如下：

{
  $jsonSchema: {
    title: 'Customers_Schema',
    properties: {
      CustID: {
        bsonType: 'int'
      },
      CustName: {
        bsonType: 'string'
      },
      CustPhone: {
        bsonType: 'string'
      },
      CustAddress: {
        bsonType: 'string'
      },
      Source: {
        bsonType: [
          'string'
        ],
        description: 'Sources of the record'
      }
    },
    required: [
      'CustID',
      'CustName',
      'Source'
    ]
  }
}

操作触发BulkWriteError，提示Source字段类型为array，与预期的['string']不匹配。我想知道这两种类型是否等价，PyMongo是否会自动处理二进制转换，是否需要在Python代码中提前做类型转换？错误片段如下：

{'operatorName': 'bsonType', 'specifiedAs': {'bsonType': [...]}, 'reason': 'type did not match', 'consideredValue': ['LoanDelivery_2022-03-31'], 'consideredType': 'array'}
special variables
function variables
'operatorName' = 'bsonType'
'specifiedAs' = {'bsonType': ['string']}
'reason' = 'type did not match'
'consideredValue' = ['LoanDelivery_2022-03-31']
'consideredType' = 'array'

解决方案 #

核心问题：Schema定义错误 #

你混淆了MongoDB JSON Schema中bsonType的两种用法：

• bsonType: ['string']表示字段本身的类型必须是string（数组内的元素是可选的类型范围，比如允许string或null会写['string', 'null']）
• 你实际想要的是字段类型为array，且数组内每个元素都是string，这需要用bsonType: 'array'配合items约束来定义。

修正后的Schema（适配字符串数组） #

如果Source字段需要存储字符串数组，修改Schema的Source部分：

Source: {
  bsonType: 'array',
  items: {
    bsonType: 'string'
  },
  description: 'Sources of the record'
}

替代调整（适配单个字符串） #

如果你的需求是Source字段存储单个字符串而非数组，修改插入的文档即可：

{'Source': 'LoanDelivery_2022-03-31', 'CustID': 1, 'CustName': 'Seexxx', 'CustPhone': '940xxxxx', '_id': ObjectId('66ca8d5873a3fdxxxx')}

关于PyMongo的类型转换 #

PyMongo会自动将Python的list转换为MongoDB的array类型，无需手动做二进制转换。本次问题完全是Schema定义不符合实际数据类型导致的，和PyMongo的转换逻辑无关。

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