17370845950

EF Core Fluent API 是在 OnModelCreating 方法中通过 ModelBuilder 配置模型的推荐方式，比数据注解更灵活、解耦更强，适合复杂场景；配置必须在此方法中编写，建议拆分到实现 IEntityTypeConfiguration 的独立类中；支持表名列名修改、主键设置、索引与关系配置等。

EF Core Fluent API 是在 OnModelCreating 方法中通过 ModelBuilder 对象配置模型的推荐方式，比数据注解更灵活、解耦更强，也更适合复杂场景。它不依赖属性标记，所有配置集中管理，便于维护和跨数据库适配。

在哪写 Fluent API 配置

重写 DbContext 类中的 OnModelCreating 方法，在里面调用 modelBuilder 的链式方法：

• 配置入口固定：必须在 protected override void OnModelCreating(ModelBuilder modelBuilder) 中编写

• 不能在构造函数或 OnConfiguring 中调用，否则会报错
• 建议把不同实体的配置拆到单独的配置类（实现 IEntityTypeConfiguration），再在 OnModelCreating 中批量注册，保持主方法简洁

最常用的基础配置示例

以下是在 OnModelCreating 中直接写的典型操作：

• 改表名：modelBuilder.Entity().ToTable("Users")
• 改列名 + 类型 + 长度：modelBuilder.Entity().Property(u => u.Email).HasColumnName("email_address").HasColumnType("varchar(255)").IsRequired()
• 设主键 + 自增：modelBuilder.Entity().HasKey(o => o.Id); modelBuilder.Entity().Property(o => o.Id).ValueGeneratedOnAdd()
• 设复合主键：modelBuilder.Entity().HasKey(oi => new { oi.OrderId, oi.ProductId })

索引与关系怎么配

索引和导航关系是性能和数据完整性关键，Fluent API 提供清晰语法：

• 单列唯一索引：modelBuilder.Entity().HasIndex(u => u.Email).IsUnique()
• 复合索引（带自定义名）：modelBuilder.Entity().HasIndex(u => new { u.Status, u.CreatedAt }).HasDatabaseName("IX_Users_Status_CreatedAt")
• 一对多关系（显式外键）：modelBuilder.Entity().HasOne(p => p.Blog).WithMany(b => b.Posts).HasForeignKey(p => p.BlogId)
• 多对多（EF Core 5+）：modelBuilder.Entity().HasMany(s => s.Teachers).WithMany(t => t.Students).UsingEntity(j => j.ToTable("StudentTeacher"))

为什么优先用 Fluent API 而不是特性

这不是“好不好看”的问题，而是工程实践的合理性：

• 实体类专注业务逻辑，不掺杂数据库映射细节
• 同一实体可适配不同数据库（比如 SQL Server 用 nvarchar，MySQL 用 varchar），只需在配置里加判断，不用改实体
• 支持数据注解做不到的事：比如配置影子属性、值转换器、过滤全局查询条件（Global Query Filters）、复杂索引选项（包含列、排序方向等）
• 配置优先级最高，会覆盖约定和数据注解，避免隐式冲突

基本上就这些。上手不难，关键是养成“实体归实体、配置归配置”的习惯。