.NET Core API对接MongoDB POST请求序列化错误求助

错误原因 #

你遇到的BsonSerializationException核心原因是：
ASP.NET Core默认使用System.Text.Json反序列化请求体，当模型属性为Object[]时，JSON中的对象会被反序列化为JsonElement类型；而MongoDB驱动默认不支持序列化JsonElement，因此写入数据库时触发序列化错误。

解决方案 #

针对你Testdata元素结构不固定的场景，推荐以下两种可行方案：

方案一：改用MongoDB原生BsonDocument[]类型 #

BsonDocument是MongoDB驱动原生支持的类型，可直接完成序列化/反序列化，无需额外兼容配置：

1. 修改模型类

public class MyModel
{
    [BsonId]
    [BsonRepresentation(BsonType.ObjectId)]
    public string? Id { get; set; }
  
    // 替换Object[]为BsonDocument[]
    [JsonPropertyName("testData")] // 确保与JSON中的驼峰字段名匹配
    public BsonDocument[] Testdata { get; set; }
}

2. 添加JSON到BsonDocument的转换器
   由于ASP.NET Core默认无法直接将JSON反序列化为BsonDocument，需自定义转换器：

public class BsonDocumentJsonConverter : JsonConverter<BsonDocument>
{
    public override BsonDocument Read(ref Utf8JsonReader reader, Type typeToConvert, JsonSerializerOptions options)
    {
        using var jsonDoc = JsonDocument.ParseValue(ref reader);
        return BsonDocument.Parse(jsonDoc.RootElement.GetRawText());
    }

    public override void Write(Utf8JsonWriter writer, BsonDocument value, JsonSerializerOptions options)
    {
        writer.WriteRawValue(value.ToJson());
    }
}

3. 注册转换器到ASP.NET Core
   在Program.cs中配置JsonOptions：

builder.Services.AddControllers()
    .AddJsonOptions(options =>
    {
        options.JsonSerializerOptions.Converters.Add(new BsonDocumentJsonConverter());
        // 可选：开启驼峰命名自动映射，避免手动添加JsonPropertyName
        options.JsonSerializerOptions.PropertyNamingPolicy = JsonNamingPolicy.CamelCase;
    });

方案二：使用JsonElement[]并配置MongoDB序列化支持 #

如果不想改用BsonDocument，可以保留JsonElement[]类型，为MongoDB驱动添加JsonElement的序列化器：

1. 修改模型类

public class MyModel
{
    [BsonId]
    [BsonRepresentation(BsonType.ObjectId)]
    public string? Id { get; set; }
  
    [JsonPropertyName("testData")]
    public JsonElement[] Testdata { get; set; }
}

2. 实现JsonElement的MongoDB序列化器

public class JsonElementSerializer : IBsonSerializer<JsonElement>
{
    public Type ValueType => typeof(JsonElement);

    public JsonElement Deserialize(BsonDeserializationContext context, BsonDeserializationArgs args)
    {
        var bsonDoc = BsonDocumentSerializer.Instance.Deserialize(context, args);
        return JsonDocument.Parse(bsonDoc.ToJson()).RootElement;
    }

    public void Serialize(BsonSerializationContext context, BsonSerializationArgs args, JsonElement value)
    {
        var bsonDoc = BsonDocument.Parse(value.GetRawText());
        BsonDocumentSerializer.Instance.Serialize(context, args, bsonDoc);
    }

    // 实现IBsonSerializer的非泛型接口方法
    object IBsonSerializer.Deserialize(BsonDeserializationContext context, BsonDeserializationArgs args)
        => Deserialize(context, args);

    void IBsonSerializer.Serialize(BsonSerializationContext context, BsonSerializationArgs args, object value)
        => Serialize(context, args, (JsonElement)value);
}

3. 配置MongoDB客户端使用自定义序列化器
   在注册MongoDB服务时添加序列化配置：

builder.Services.AddSingleton<IMongoClient>(sp =>
{
    var connectionString = "你的MongoDB连接字符串";
    var settings = MongoClientSettings.FromConnectionString(connectionString);
    
    // 注册JsonElement序列化器
    var serializerRegistry = BsonSerializerRegistry.Create(new BsonSerializerConfiguration
    {
        Serializers = { new JsonElementSerializer() }
    });
    settings.SerializerRegistry = serializerRegistry;
    
    return new MongoClient(settings);
});

额外注意事项 #

• 确认模型属性名与JSON字段名匹配：前端请求用的是testData（驼峰），模型中是Testdata，建议通过JsonPropertyName特性或开启驼峰命名映射确保字段正确绑定。
• 测试时可在控制器中打印document.Testdata的类型，确认反序列化结果符合预期。

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