如何在ASP.NET Core中使用MongoDB.Driver实现数据迁移与种子数据填充？

完全理解你的顾虑——用MongoDB时确实不像EF Core那样有现成的Migration工具，但针对结构变更和种子数据的需求，有不少成熟方案可以避免重复造轮子，我结合实际项目经验给你梳理下：

一、数据迁移：替代EF Core Migration的方案 #

MongoDB是无模式数据库，但业务发展中难免遇到字段重命名、类型转换、新增必填字段这类需要批量修改数据的场景，这里有两种主流思路：

1. 使用第三方迁移库 #

有专门为MongoDB设计的迁移工具，比如MongoDB.Migration或者MongoMigrations，这类库的核心逻辑和EF Migration类似：

• 为每个迁移步骤创建版本化的脚本类，包含Up（执行迁移）和Down（回滚，可选）方法
• 应用启动时自动检查数据库中的迁移版本记录，执行未完成的迁移操作
• 支持批量修改文档、索引调整等常见结构变更需求

2. 自定义轻量迁移逻辑 #

如果不想引入第三方依赖，自己实现一套也很简单，核心是版本控制+批量操作：

• 第一步：在数据库中创建一个专门的集合（比如__migrations），用来记录已执行的迁移版本号
• 第二步：定义迁移接口，比如：

  public interface IMigration
  {
      int Version { get; }
      Task UpAsync(IMongoDatabase database);
  }
  

• 第三步：实现具体的迁移类，比如处理字段重命名的迁移：

  public class Migration_20240520_RenameOldFieldToNewField : IMigration
  {
      public int Version => 20240520;
  
      public async Task UpAsync(IMongoDatabase database)
      {
          var collection = database.GetCollection<BsonDocument>("yourCollection");
          var updateDefinition = Builders<BsonDocument>.Update
              .Rename("oldFieldName", "newFieldName");
          
          await collection.UpdateManyAsync(_ => true, updateDefinition);
      }
  }
  

• 第四步：在ASP.NET Core启动时（比如Program.cs），扫描所有IMigration实现类，对比__migrations中的记录，执行未执行的迁移

二、种子数据填充：简单高效的实现方式 #

种子数据的需求MongoDB.Driver可以很直接地实现，不需要复杂工具，推荐两种方式：

1. 启动时直接初始化 #

在应用启动流程中添加种子数据逻辑，比如：

var mongoClient = builder.Services.GetRequiredService<IMongoClient>();
var database = mongoClient.GetDatabase("yourDbName");
var usersCollection = database.GetCollection<User>("users");

// 检查是否存在初始数据，不存在则插入
var hasAdmin = await usersCollection.Find(u => u.Role == "Admin").AnyAsync();
if (!hasAdmin)
{
    await usersCollection.InsertOneAsync(new User
    {
        Id = ObjectId.GenerateNewId(),
        Username = "admin",
        Role = "Admin",
        CreatedAt = DateTime.UtcNow
    });
}

2. 封装成独立的种子服务 #

如果种子数据较多，可以封装成SeedService，注入到启动流程中，方便维护和扩展：

public class SeedService
{
    private readonly IMongoDatabase _database;

    public SeedService(IMongoDatabase database)
    {
        _database = database;
    }

    public async Task SeedAllAsync()
    {
        await SeedUsersAsync();
        await SeedCategoriesAsync();
        // 其他集合的种子数据
    }

    private async Task SeedUsersAsync()
    {
        // 具体种子逻辑
    }
}

然后在Program.cs中调用：

var seedService = app.Services.GetRequiredService<SeedService>();
await seedService.SeedAllAsync();

三、针对结构变更的注意事项 #

你提到的“真正的数据结构变更”场景，需要注意：

• 字段类型转换：比如把字符串类型的age改成整数，需要遍历所有文档，转换后更新，避免后续读写报错
• 新增必填字段：如果业务要求字段必须存在，迁移时要给所有旧文档设置默认值，同时在实体类中标记为必填（比如用[Required]）
• 索引调整：如果结构变更涉及索引（比如新增字段需要加索引），迁移脚本中要包含索引的创建/删除逻辑

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