MongoDB集合字段重命名后C#查询失效问题排查

这问题其实很直观——你在MongoDB里把集合的Name字段重命名成了Name1，但你的C#实体类MyClass里对应的属性还是叫Name，MongoDB驱动默认是按属性名和字段名严格匹配来做映射的，两边名字对不上，自然查不到数据了。

先看你的代码：

public class MyClass{ 
    public int Name {get; set;} 
    public int Description {get; set;} 
} 
static void Main() { 
    var builder = Builders<MyClass>.Filter; 
    var query = builder.Eq( a => a.Name, "John"); 
    Console.WriteLine(collection.Find(query).Result); 
}

这段代码里，查询条件是匹配实体类的Name属性，驱动会把它转换成MongoDB里的Name字段查询，但你数据库里已经改成Name1了，相当于查了一个不存在的字段，结果肯定是空的。

给你几个可行的解决方案：

• 方案一：用特性指定字段映射（最常用）
  不用改实体类的属性名，给Name属性加上BsonElement特性，明确告诉驱动它对应数据库里的Name1字段：

  using MongoDB.Bson.Serialization.Attributes;
  
  public class MyClass{ 
      [BsonElement("Name1")] // 绑定到数据库的Name1字段
      public int Name {get; set;} 
      public int Description {get; set;} 
  }
  

• 方案二：全局类映射配置
  如果你不想在实体类里加特性，可以在程序启动阶段（比如Main方法开头）注册类映射规则：

  using MongoDB.Bson.Serialization;
  
  static void Main() { 
      // 注册MyClass的映射规则
      BsonClassMap.RegisterClassMap<MyClass>(cm => {
          cm.AutoMap();
          cm.GetMemberMap(c => c.Name)
            .SetElementName("Name1");
      });
  
      var builder = Builders<MyClass>.Filter; 
      var query = builder.Eq( a => a.Name, "John"); 
      Console.WriteLine(collection.Find(query).Result); 
  }
  

• 方案三：直接用数据库字段名写查询（临时应急）
  这种方式跳过实体类映射，直接指定数据库里的字段名，适合临时调试，但不推荐长期用（不利于代码维护）：

  var query = builder.Eq("Name1", "John"); // 直接写数据库字段名
  

最后提醒一句：以后改数据库字段的时候，一定要同步更新实体类的映射关系，不然很容易出现这种“代码和数据不同步”的问题。

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