重启之路13：吃透EF Core10 Fluent API，多实体配置从此不翻车

36岁重走.NET开发路，踩过无数坑才发现：想让项目代码清爽、数据库映射不混乱，吃透EF Core 10的Fluent API是关键！

许多程序员用EF Core只会靠默认约定，遇到表名自定义、多实体关联、查询优化就抓瞎，配置代码全堆在一个方法里，几十行就乱成麻，后续维护改一行怕崩全片。

今天就把Fluent API的完整实战用法+多实体企业级最佳实践一次性讲透，从基础配置到高阶解耦，全程带可直接复制的代码，新手能抄作业，老程序员能避坑，学会后再多实体也能轻松拿捏！

一、核心入口：记住这个方法，所有配置全搞定

不管多复杂的映射需求，Fluent API的所有配置都只在DbContext的OnModelCreating方法中，这是EF Core实体映射数据库的唯一核心入口，先把这个基础模板存好，直接套用不踩雷！

public class AppDbContext : DbContext
{
    // 实体关联数据库表，按需添加
    public DbSet<User> Users { get; set; }
    public DbSet<Order> Orders { get; set; }
    public DbSet<Product> Products { get; set; }

    // 配置数据库连接，替换成自己的连接串
    protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
    {
        optionsBuilder.UseSqlServer("你的数据库连接字符串");
    }

    // 重点：所有Fluent API配置全写在这！
    protected override void OnModelCreating(ModelBuilder modelBuilder)
    {
        // 后续配置、多实体处理全在这
    }
}

✅ 关键知识点：

• DbSet<T>是实体和数据库表的桥梁，EF Core靠它识别要映射的表；
• 默认按「类名复数」生成表名（如User→Users），Fluent API就是用来打破默认，自定义规则的；
• 这个模板是所有配置的基础，不管项目多大，核心结构不变。

重启之路13：吃透EF Core10 Fluent API，多实体配置从此不翻车

二、基础配置：90%开发场景全覆盖，代码可直接复制

日常开发中，表映射、主键、字段、索引、实体关系这5块，能覆盖绝大多数业务需求，每段代码都带详细注释，改改字段名就能直接用在项目里！

1. 表/视图映射：告别默认丑表名，忽略无用实体

解决EF Core默认表名不规范的问题，还能映射视图、排除无需持久化的实体，一行代码一个需求，超省心！

// 自定义表名+Schema，企业项目规范必备（如User→T_User）
modelBuilder.Entity<User>().ToTable("T_User", "dbo");
// 映射数据库视图，只读查询专用（不用手动建表，查视图更高效）
modelBuilder.Entity<User>().ToView("V_User");
// 忽略实体，不生成数据库表（仅做代码业务处理，无需存库）
modelBuilder.Ignore<UnusedEntity>();

2. 主键配置：单主键/复合主键/自增，随心配置

主键是表的核心，复合主键专为订单明细、中间表设计，自增开关可根据业务灵活控制，再也不用被默认规则绑死！

// 自定义单主键（默认Id为主键，可指定其他字段如UserId）
modelBuilder.Entity<User>().HasKey(u => u.UserId);
// 复合主键（多列联合，订单明细/多对多中间表必用）
modelBuilder.Entity<OrderItem>().HasKey(oi => new { oi.OrderId, oi.ProductId });
// 主键自增（新增数据数据库自动生成，最常用）
modelBuilder.Entity<User>().Property(u => u.UserId).ValueGeneratedOnAdd();
// 禁用自增（手动赋值，适用于有业务含义的主键如手机号、订单号）
modelBuilder.Entity<User>().Property(u => u.UserId).ValueGeneratedNever();

3. 字段配置：规范数据库字段，避坑最关键

这是Fluent API最常用的功能，解决C#属性和数据库字段的映射差异，自定义列名、类型、非空、默认值，还能加注释，后续维护不用翻业务代码，看数据库就懂！

modelBuilder.Entity<User>(entity =>
{
    entity.Property(u => u.UserName).HasColumnName("user_name"); // 驼峰转下划线
    entity.Property(u => u.Password).HasColumnType("varchar(100)"); // 指定字段类型
    entity.Property(u => u.Email).IsRequired(); // 字段非空，必填项
    entity.Property(u => u.NickName).HasMaxLength(50); // 字符串最大长度
    entity.Property(u => u.UserName).IsUnicode(false); // 纯英文关Unicode，省存储空间
    entity.Property(u => u.Status).HasDefaultValue(1); // 程序层默认值（正常状态）
    entity.Property(u => u.CreateTime).HasDefaultValueSql("GETDATE()"); // 数据库层默认当前时间
    entity.Ignore(u => u.TempData); // 忽略临时字段，不生成数据库列
    entity.Property(u => u.Email).HasComment("用户登录邮箱，唯一不可重复"); // 字段注释，方便维护
});

⚠️ 重大区分：程序默认值在代码赋值时生效，数据库默认值插入数据时自动生成，别搞混！

4. 索引配置：查询速度翻倍，EF Core10新特性超实用

索引是数据库查询优化的核心，唯一索引还能防止重复数据，EF Core10新增的筛选索引更是精准优化，只对有效数据建索引，体积更小、速度更快！

// 普通索引，提升单一字段查询速度（如按邮箱查用户）
modelBuilder.Entity<User>().HasIndex(u => u.Email);
// 唯一索引，保证字段值唯一（如邮箱、手机号不重复）
modelBuilder.Entity<User>().HasIndex(u => u.Email).IsUnique();
// 复合索引，多条件组合查询优化（如按省+市查用户）
modelBuilder.Entity<User>().HasIndex(u => new { u.Province, u.City });
// EF Core10新增：筛选索引（仅对有效订单建索引，效率拉满）
modelBuilder.Entity<Order>().HasIndex(o => o.Status).HasFilter("[Status] = 1");

5. 实体关系配置：三大关系一网打尽，EF Core10简化多对多

开发中最常见的一对多、一对一、多对多关系，配置逻辑超清晰，重点把控外键和删除行为，EF Core10还简化了多对多配置，少写一半冗余代码！

重启之路13：吃透EF Core10 Fluent API，多实体配置从此不翻车

✅ 一对多（最常用：用户-订单、分类-商品）

modelBuilder.Entity<Order>()
    .HasOne(o => o.User)          // 订单关联1个用户（父实体）
    .WithMany(u => u.Orders)      // 用户拥有多个订单（子实体）
    .HasForeignKey(o => o.UserId) // 定义外键字段
    .IsRequired()                 // 外键必填，不允许为空
    .OnDelete(DeleteBehavior.Cascade); // 级联删除：删用户同时删其订单

删除行为可选：Cascade（级联删除）、Restrict（禁止删除，有子数据抛错）、SetNull（外键设空，需外键可空）。

✅ 一对一（实体拆分：用户-用户详情）

modelBuilder.Entity<User>()
    .HasOne(u => u.UserProfile)   // 用户关联1个详情
    .WithOne(p => p.User)         // 详情关联1个用户
    .HasForeignKey<UserProfile>(p => p.UserId) // 外键放在从表
    .OnDelete(DeleteBehavior.Restrict); // 禁止级联删除，避免误删核心数据

✅ 多对多（EF Core10简化版：商品-分类）

无额外字段自动生成中间表，有额外字段（如排序、创建时间）手动定义实体即可，简单高效！

// 无额外字段：自动生成中间表，无需手动定义（推荐）
modelBuilder.Entity<Product>()
    .HasMany(p => p.Categories)
    .WithMany(c => c.Products);

// 有额外字段：手动定义中间实体+配置（如排序权重）
modelBuilder.Entity<ProductCategory>().HasKey(pc => new { pc.ProductId, pc.CategoryId });
modelBuilder.Entity<ProductCategory>()
    .HasOne(pc => pc.Product).WithMany(p => p.ProductCategories).HasForeignKey(pc => pc.ProductId);
modelBuilder.Entity<ProductCategory>()
    .HasOne(pc => pc.Category).WithMany(c => c.ProductCategories).HasForeignKey(pc => pc.CategoryId);

重启之路13：吃透EF Core10 Fluent API，多实体配置从此不翻车

三、核心痛点解决：多实体项目，告别代码臃肿！

这是本文最核心的干货！当项目实体达到几十个甚至上百个时，把所有配置堆在OnModelCreating里，代码必乱成麻！

业内主流的企业级标准化解决方案：独立配置类+批量应用+通用约定+模块化拆分，实体再多也能轻松管理，改代码不影响其他模块，团队协作超友善！

方式1：独立配置类（核心方案，必用！）

每个实体对应一个单独的配置类，实现IEntityTypeConfiguration<T>接口，把该实体的所有配置封装进去，符合单一职责原则，改哪个实体就找哪个类，再也不用翻几百行代码！

// User实体专属配置类，所有User配置全在这
public class UserConfiguration : IEntityTypeConfiguration<User>
{
    public void Configure(EntityTypeBuilder<User> builder)
    {
        builder.ToTable("T_User");
        builder.HasKey(u => u.Id);
        builder.Property(u => u.UserName).IsRequired().HasMaxLength(50);
        builder.HasIndex(u => u.Email).IsUnique();
        // 其他配置全写在此处
    }
}

// Order实体专属配置类，同理
public class OrderConfiguration : IEntityTypeConfiguration<Order>
{
    public void Configure(EntityTypeBuilder<Order> builder)
    {
        builder.ToTable("T_Order");
        builder.HasKey(o => o.Id);
        builder.HasOne(o => o.User).WithMany(u => u.Orders).HasForeignKey(o => o.UserId);
    }
}

方式2：批量应用配置（一行代码搞定所有，超便捷）

不用手动逐个注册配置类，EF Core自带批量扫描方法，自动加载当前程序集下所有配置类，新增实体只需加配置类，不用改原有代码，完全解耦！

protected override void OnModelCreating(ModelBuilder modelBuilder)
{
    // 一行代码：批量扫描+应用所有实体配置类，懒人福音
    modelBuilder.ApplyConfigurationsFromAssembly(Assembly.GetExecutingAssembly());
}

方式3：通用约定批量配置（减少重复代码，大型项目必备）

多个实体都有通用规则（如主键Id、创建时间CreateTime、软删除IsDeleted），不用每个配置类重复写，通过反射批量设置，统一应用规则，大幅减少冗余代码！

protected override void OnModelCreating(ModelBuilder modelBuilder)
{
    // 先批量应用独立配置类
    modelBuilder.ApplyConfigurationsFromAssembly(Assembly.GetExecutingAssembly());

    // 再批量配置通用规则，一次写好，所有实体生效
    foreach (var entityType in modelBuilder.Model.GetEntityTypes())
    {
        // 规则1：所有Id主键自动自增
        var idProp = entityType.FindProperty("Id");
        if (idProp != null) idProp.ValueGenerated = ValueGenerated.OnAdd;

        // 规则2：CreateTime默认当前时间，且非空
        var createTime = entityType.FindProperty("CreateTime");
        if (createTime != null)
        {
            createTime.SetDefaultValueSql("GETDATE()");
            createTime.IsRequired = true;
        }

        // 规则3：软删除IsDeleted默认false，避免查已删除数据
        var isDeleted = entityType.FindProperty("IsDeleted");
        if (isDeleted != null) isDeleted.SetDefaultValue(false);
    }
}

方式4：模块化拆分+分部类（超大型项目终极方案）

对于微服务、DDD架构的超大型项目，按业务模块（用户、订单、商品）拆分配置类，用partial分部类拆分DbContext，避免单个文件代码过长，查找和维护效率翻倍！

✅ 标准化项目结构（直接照搬）

项目根目录
├─ EntityConfigurations（配置类总文件夹）
│  ├─ UserModule（用户模块）
│  │  ├─ UserConfiguration.cs
│  │  ├─ UserProfileConfiguration.cs
│  ├─ OrderModule（订单模块）
│  │  ├─ OrderConfiguration.cs
│  │  ├─ OrderItemConfiguration.cs
│  ├─ ProductModule（商品模块）
│  │  ├─ ProductConfiguration.cs
│  │  ├─ CategoryConfiguration.cs

✅ 分部类拆分DbContext

// 用户模块分部类：只放用户相关实体
public partial class AppDbContext
{
    public DbSet<User> Users { get; set; }
    public DbSet<UserProfile> UserProfiles { get; set; }
}

// 订单模块分部类：只放订单相关实体
public partial class AppDbContext
{
    public DbSet<Order> Orders { get; set; }
    public DbSet<OrderItem> OrderItems { get; set; }
}

// 主上下文：仅保留核心配置，代码超简洁
public partial class AppDbContext : DbContext
{
    protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
    {
        optionsBuilder.UseSqlServer("连接字符串");
    }

    protected override void OnModelCreating(ModelBuilder modelBuilder)
    {
        modelBuilder.ApplyConfigurationsFromAssembly(Assembly.GetExecutingAssembly());
    }
}

重启之路13：吃透EF Core10 Fluent API，多实体配置从此不翻车

四、必记重点：2个优先级，别用错！

1. 多实体处理方式优先级（业内规范）

从中小型项目到超大型微服务，按这个优先级选，既符合开发规范，又能兼顾效率和维护性：
✅ 首选：独立配置类+批量扫描应用（中小型到大型项目通用，简单高效）
✅ 进阶：按模块拆分配置类（大型项目/DDD项目，团队协作友善）
✅ 优化：通用约定批量配置（减少重复代码，统一实体规范）
✅ 高阶：分部类拆分DbContext（超大型项目，彻底解决代码臃肿）