EF Core多数据库测试中MongoDB主键映射报错的解决咨询

可以在IsolatedRepositoryMongoDbIntegrationTests中添加专属配置解决该问题，且不会影响现有SQL数据库的测试，具体实现如下：

实现步骤 #

1. 编写MongoDB专属配置扩展 #

创建针对TestEntity的MongoDB映射配置扩展，仅在MongoDB测试中使用：

public static class MongoDbModelBuilderExtensions
{
    public static void ConfigureMongoDbTestEntity(this ModelBuilder modelBuilder)
    {
        // 显式将TestEntity的Id属性映射到MongoDB的_id字段
        modelBuilder.Entity<TestEntity>()
            .Property(e => e.Id)
            .HasField("_id")
            .UsePropertyAccessMode(PropertyAccessMode.PreferField);
    }
}

2. 在测试初始化中应用专属配置 #

在测试类的初始化逻辑中，构建MongoDB的DbContextOptions时，先应用原有配置，再叠加MongoDB专属的主键映射配置：

[TestClass]
public class IsolatedRepositoryMongoDbIntegrationTests
{
    private TestDbContext _dbContext;

    [TestInitialize]
    public void Setup()
    {
        var options = new DbContextOptionsBuilder<TestDbContext>()
            .UseMongoDB("mongodb://localhost:27017/TestDb")
            .UseModel(builder =>
            {
                // 先加载原有的实体配置（TestEntityTypeConfiguration）
                builder.ApplyConfiguration(new TestEntityTypeConfiguration());
                // 叠加MongoDB专属的主键映射配置
                builder.ConfigureMongoDbTestEntity();
            })
            .Options;

        _dbContext = new TestDbContext(options);
        _dbContext.Database.EnsureCreated();
    }

    // 测试方法实现...
}

原理说明 #

EF Core的MongoDB提供器要求实体主键必须映射到MongoDB的_id字段，而原有SQL数据库的配置可能未考虑这一点。通过在测试中单独叠加MongoDB专属配置，既满足了MongoDB的映射要求，又不会修改原有实体和配置类，确保SQL数据库测试不受影响。

相关参考内容 #

• EF Core MongoDB提供器中，主键默认会自动映射名为Id的属性到_id字段，但如果原有配置显式指定了主键的列名（针对SQL），则需要通过HasField方法重新指定MongoDB的字段映射。
• UsePropertyAccessMode(PropertyAccessMode.PreferField)确保EF Core优先使用MongoDB的_id字段进行数据读写，避免属性访问逻辑冲突。

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