Mongo C# Driver处理$search聚合复合must子句Bson序列化失败

问题背景 #

我有一个MongoDB Atlas Search索引，在MongoDB Compass中编写的以下$search聚合语句可以正常运行并返回结果：

{
  index: "ShipmentProjections",
  compound: {
    must: {
      equals: {
        value: 208414,
        path: "MerchantId",
      },
    },
    must: {
      in: {
        path: "ShipmentId",
        value: [100405234]
      }
    }
  },
}

但将这段语句转换为C#代码时，使用MongoDb.Bson 2.23.2版本驱动调用BsonDocument.Parse(searchQuery)会抛出异常。

报错信息 #

System.InvalidOperationException: Duplicate element name 'must'.
   at MongoDB.Bson.BsonDocument.Add(BsonElement element)
   at MongoDB.Bson.BsonDocument.Add(String name, BsonValue value)
   at MongoDB.Bson.Serialization.Serializers.BsonDocumentSerializer.DeserializeValue(BsonDeserializationContext context, BsonDeserializationArgs args)
   at MongoDB.Bson.Serialization.Serializers.BsonValueSerializerBase`1.Deserialize(BsonDeserializationContext context, BsonDeserializationArgs args)
   at MongoDB.Bson.Serialization.IBsonSerializerExtensions.Deserialize[TValue](IBsonSerializer`1 serializer, BsonDeserializationContext context)
   at MongoDB.Bson.Serialization.Serializers.BsonValueSerializer.DeserializeValue(BsonDeserializationContext context, BsonDeserializationArgs args)
   at MongoDB.Bson.Serialization.Serializers.BsonValueSerializerBase`1.Deserialize(BsonDeserializationContext context, BsonDeserializationArgs args)
   at MongoDB.Bson.Serialization.IBsonSerializerExtensions.Deserialize[TValue](IBsonSerializer`1 serializer, BsonDeserializationContext context)
   at MongoDB.Bson.Serialization.Serializers.BsonDocumentSerializer.DeserializeValue(BsonDeserializationContext context, BsonDeserializationArgs args)
   at MongoDB.Bson.Serialization.Serializers.BsonValueSerializerBase`1.Deserialize(BsonDeserializationContext context, BsonDeserializationArgs args)
   at MongoDB.Bson.Serialization.IBsonSerializerExtensions.Deserialize[TValue](IBsonSerializer`1 serializer, BsonDeserializationContext context)
   at MongoDB.Bson.BsonDocument.Parse(String json)

测试结论 #

• must子句仅能包含一个条件，且must内不支持and选项
• compound语句也不支持and选项
• 唯一能通过Compass验证的写法是在compound下设置多个must键，每个must包含一个条件

解决方案 #

1. 避免重复键的标准写法（推荐） #

MongoDB Atlas Search的compound操作符中，must字段本身支持接收条件数组，多个条件会自动按逻辑与（AND）处理，这是符合JSON规范的标准写法，C#驱动可以正常解析。

修正后的查询语句如下：

{
  "index": "ShipmentProjections",
  "compound": {
    "must": [
      {
        "equals": {
          "value": 208414,
          "path": "MerchantId"
        }
      },
      {
        "in": {
          "path": "ShipmentId",
          "value": [100405234]
        }
      }
    ]
  }
}

将这段JSON传入BsonDocument.Parse()即可正常解析，同时Atlas Search能正确执行查询逻辑。

2. 关于重复键的说明 #

MongoDB Compass允许重复键的写法属于非标准兼容处理（可能内部会保留最后一个重复键或合并），但JSON规范中对象不允许存在重复键，C#的BsonDocument严格遵循这一规范，因此无法解析带有重复键的JSON字符串。不建议尝试强制兼容重复键写法，使用数组形式的标准写法是最优解。

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