如何正确使用ApplyConfigurationsFromAssembly批量应用实体配置？

核心排查与解决步骤 #

1. 配置类必须实现正确接口 #

所有映射配置类必须实现IEntityTypeConfiguration<T>泛型接口（T对应目标实体类型），且类的访问修饰符为public。示例：

public class MyEntity1Map : IEntityTypeConfiguration<MyEntity1>
{
    public void Configure(EntityTypeBuilder<MyEntity1> builder)
    {
        // 字段映射、索引、关联关系等配置逻辑
    }
}

未实现接口或类非public时，EF Core扫描会直接忽略该配置类。

2. 确认扫描的程序集正确 #

你的配置类和MyDbContext都在Data项目下，使用typeof(MyDbContext).Assembly是正确的，但需确保：

• Data项目已被启动项目MyApp正确引用
• 清理并重新生成整个解决方案，避免编译缓存导致配置类未被纳入程序集

3. 替换为批量扫描的代码 #

删除所有手动调用ApplyConfiguration的代码，改用批量扫描：

protected override void OnModelCreating(ModelBuilder modelBuilder)
{
    // 扫描Data项目中所有符合要求的配置类
    modelBuilder.ApplyConfigurationsFromAssembly(typeof(MyDbContext).Assembly);
}

若配置类在Domain项目中，替换为typeof(MyEntity1).Assembly（指向实体所在程序集）即可。

4. 排除映射冲突 #

若仍报错，检查是否存在多个配置类对同一实体重复定义映射的情况，此类冲突会导致EF Core无法识别有效配置。

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