C#如何使用EF Core的Fluent API_C# Code First配置实体映射【实战】-C#.Net教程-PHP中文网

fluent api 是 ef core 中最灵活、最可控的实体配置方式，能覆盖复合主键、自定义架构、忽略计算属性、级联删除等数据注解和约定无法实现的功能；但需注意 base.onmodelcreating 必须置于末尾或省略，确保实体已声明且配置顺序正确，否则表名、外键等设置可能不生效。

c#如何使用ef core的fluent api_c# code first配置实体映射【实战】

Fluent API 是 EF Core 中最灵活、最可控的实体配置方式，它能覆盖所有约定和数据注解做不到的事——比如复合主键、自定义架构、忽略计算属性、设置级联删除行为。但直接往 OnModelCreating 里堆配置容易失控，新手常卡在“写了没生效”“改了表名但迁移不更新”“外键关系错乱”这几个点上。

为什么 `OnModelCreating` 里的配置不生效？

最常见的原因是：你调用了 base.OnModelCreating(modelBuilder)，但把它放在了自定义配置之后。EF Core 的约定逻辑会在 base 调用时立即执行，之后再调用 modelBuilder.Entity<t>().ToTable(...)</t> 就晚了——表名已被约定锁定，不会被覆盖。

必须把 base.OnModelCreating(modelBuilder) 放在方法末尾，或者干脆删掉（除非你重写了父类逻辑）
确保实体类型已通过 DbSet<t></t> 在 DbContext 中声明，否则 modelBuilder.Entity<t>()</t> 不会触发任何映射
如果使用了 IEntityTypeConfiguration<t></t> 分离配置，要记得在 OnModelCreating 中调用 modelBuilder.ApplyConfigurationsFromAssembly(Assembly.GetExecutingAssembly())

`HasKey` 和 `HasAlternateKey` 的实际区别

HasKey 指定的是数据库主键（primary key），直接影响 INSERT 行为和索引；HasAlternateKey 配置的是唯一约束（unique constraint），不参与标识列生成，也不影响外键引用方式，但它能让 EF Core 把该字段当“候选键”来处理导航关系。

"避开 C# 常见错误——空陷阱、异步陷阱、LINQ 陷阱及资源泄漏。"

下载

主键必须非空，且每个实体只能有一个 HasKey
HasAlternateKey 可以有多个，适合给邮箱、身份证号这类业务唯一字段加约束
若用 HasOne(x => x.User).WithOne().HasForeignKey<profile>(x => x.Email)</profile>，EF Core 会报错——因为 Email 不是主键，也不是 alternate key；得先加 modelBuilder.Entity<user>().HasAlternateKey(x => x.Email)</user>

表名、列名、架构三者怎么一起配才不出错？

顺序和作用域很重要：ToTable 控制表名和 Schema，HasColumnName 控制列名，两者互不干扰，但都依赖于实体是否已被正确识别。

modelBuilder.Entity<user>().ToTable("T_Users", "auth")</user> → 表名 T_Users，Schema auth（SQL Server）或 database name（MySQL）
modelBuilder.Entity<user>().Property(x => x.Name).HasColumnName("user_name")</user> → 列名变成 user_name，不影响其他属性
如果同时用 [Table("T_Users")] 注解和 ToTable，后者优先；但注解和 Fluent API 混用会增加维护成本，建议统一用 Fluent
Schema 名在 SQLite 中无效，在 PostgreSQL 中区分大小写，测试时务必用目标数据库跑一次 dotnet ef migrations add Init

外键关系配置最容易漏掉的一步

用 HasOne/WithMany 配置完关系后，必须显式指定外键属性，否则 EF Core 会按约定生成一个隐藏的 <navigationpropertyname>Id</navigationpropertyname> 字段，导致数据库多出一列，而你的实体里根本没有对应属性。

错误写法：modelBuilder.Entity<order>().HasOne(x => x.Customer).WithMany(x => x.Orders)</order> → 自动生成 CustomerId 列，但 Order 类里没有 CustomerId 属性
正确写法：modelBuilder.Entity<order>().HasOne(x => x.Customer).WithMany(x => x.Orders).HasForeignKey(x => x.CustomerId)</order>，前提是 Order 类中有 public int CustomerId { get; set; }
如果外键属性名不符合约定（比如叫 OwnerId 而不是 CustomerId），又不想改实体类，就只能靠 HasForeignKey 显式绑定，别指望注解自动识别

Fluent API 看似自由，实则每一步都在和 EF Core 的约定机制博弈。真正难的不是写对某一行代码，而是理解哪条约定被你覆盖了、哪条还在悄悄生效——尤其是迁移生成阶段，dotnet ef migrations script 前务必检查 Up(MigrationBuilder migrationBuilder) 里的 SQL 是否符合预期。