C#向MongoDB集合插入BSON文档报错求助

这个错误的核心原因很明确：MongoDB驱动在解析你要插入的documents字段时，发现第0个元素的类型不符合预期——它期望的是一个文档对象（Object），但实际收到的结构存在格式异常（错误信息里的found 0是解析故障的反馈，本质是你的插入数据结构不符合规范）。

常见错误场景与修复方案 #

1. 检查插入方法的调用方式

你提到尝试过直接添加文档（未放入数组），那大概率是调用插入方法时传参有误：

• 如果插入单个文档，一定要用InsertOne（同步）或InsertOneAsync（异步）方法，而非InsertMany：

  // 正确的单个文档插入示例（用BsonDocument）
  var bsonDoc = new BsonDocument
  {
      { "Constituency", "Aberdeen North" },
      { "Election", "2010 General Election" },
      { "Electorate", 64808 },
      { "Majority", 8361 },
      { "ResultOfElection", "Lab Hold" },
      { "Turnout", 37701 },
      { "TurnoutPercentage", 100.0 }
  };
  
  // 假设collection是你的MongoDB集合实例
  await collection.InsertOneAsync(bsonDoc);
  

• 如果是插入多个文档，才用InsertMany，并且传入的是文档集合（比如List<BsonDocument>）：

  var docsList = new List<BsonDocument> { bsonDoc };
  await collection.InsertManyAsync(docsList);
  

2. 避免手动构造错误的BSON结构

不要手动拼接BSON字符串或者错误嵌套文档，比如这种写法绝对要避免：

// 错误示例：额外添加了"0"字段，导致驱动解析异常
var wrongDoc = new BsonDocument { { "0", bsonDoc } };
await collection.InsertOneAsync(wrongDoc);

这种写法会让MongoDB误以为你要插入的文档里有个名为0的字段，而非一个合法的选举结果文档。

3. 推荐用强类型实体插入（更不易出错）

用C#实体类映射MongoDB文档，不仅代码更清晰，还能从根源避免类型匹配错误：

// 定义实体类，属性字段对应MongoDB文档的键
public class ElectionResult
{
    public string Constituency { get; set; }
    public string Election { get; set; }
    public int Electorate { get; set; }
    public int Majority { get; set; }
    public string ResultOfElection { get; set; }
    public int Turnout { get; set; }
    public double TurnoutPercentage { get; set; }
}

// 插入实体对象
var electionResult = new ElectionResult
{
    Constituency = "Aberdeen North",
    Election = "2010 General Election",
    Electorate = 64808,
    Majority = 8361,
    ResultOfElection = "Lab Hold",
    Turnout = 37701,
    TurnoutPercentage = 100.0
};

await collection.InsertOneAsync(electionResult);

关键总结 #

这个错误本质是插入的数据结构不符合MongoDB的插入命令规范，只要确保你传入的是单个合法的BsonDocument/实体，或者多个文档的集合，并且调用对应的InsertOne/InsertMany方法，就能快速解决问题。

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