在ASP.NET Web API中，如何采用Code-Second方式实现与独立数据库的Fluent API映射？

Code-Second的核心思路是先独立设计并创建数据库，再编写实体模型，最后通过Fluent API手动建立模型与数据库对象的映射，完全绕开Code-First迁移和EDMX设计器。以下是具体实现步骤：

1. 先完成数据库的独立设计与创建 #

直接用数据库管理工具（如SSMS、pgAdmin等）创建所需的表、视图、主键/外键约束、索引、存储过程等。比如在SQL Server中创建一个Users表：

CREATE TABLE Users (
    UserId INT PRIMARY KEY IDENTITY(1,1),
    Username NVARCHAR(50) NOT NULL UNIQUE,
    Email NVARCHAR(100) NOT NULL,
    CreatedAt DATETIME DEFAULT GETDATE()
);

2. 编写实体类 #

创建与数据库表对应的实体类，不需要添加任何DataAnnotations特性（避免耦合），只保留基础属性：

public class User
{
    public int UserId { get; set; }
    public string Username { get; set; }
    public string Email { get; set; }
    public DateTime CreatedAt { get; set; }
}

3. 创建DbContext并通过Fluent API配置映射 #

继承DbContext，重写OnModelCreating方法，在其中用Fluent API定义所有映射规则，完全匹配已有的数据库结构：

public class AppDbContext : DbContext
{
    public DbSet<User> Users { get; set; }

    protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
    {
        // 配置连接字符串，指向已创建的数据库
        optionsBuilder.UseSqlServer("Your_Connection_String_Here");
    }

    protected override void OnModelCreating(ModelBuilder modelBuilder)
    {
        // 配置User实体与Users表的映射
        modelBuilder.Entity<User>(entity =>
        {
            // 指定对应的表名
            entity.ToTable("Users");

            // 配置主键
            entity.HasKey(e => e.UserId);

            // 配置UserId为自增列（匹配数据库的IDENTITY设置）
            entity.Property(e => e.UserId)
                .UseIdentityColumn();

            // 配置Username列：长度50，非空，唯一
            entity.Property(e => e.Username)
                .HasMaxLength(50)
                .IsRequired()
                .HasColumnName("Username"); // 若属性名与列名一致可省略

            // 配置Email列：长度100，非空
            entity.Property(e => e.Email)
                .HasMaxLength(100)
                .IsRequired();

            // 配置CreatedAt列：默认值为数据库的GETDATE()
            entity.Property(e => e.CreatedAt)
                .HasDefaultValueSql("GETDATE()");
        });

        // 其他实体的映射配置同理添加
    }
}

4. 禁用迁移（可选但推荐） #

因为我们不需要Code-First的迁移功能，可以在OnConfiguring中显式禁用，或者在项目中移除迁移相关包：

protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
{
    optionsBuilder.UseSqlServer("Your_Connection_String_Here")
                  .EnableSensitiveDataLogging() // 可选，用于调试
                  .UseQueryTrackingBehavior(QueryTrackingBehavior.NoTracking); // 按需配置跟踪行为

    // 禁用迁移
    optionsBuilder.UseSqlServer("Your_Connection_String_Here", b => b.MigrationsAssembly(null));
}

5. 测试数据操作 #

现在可以正常使用DbContext进行CRUD操作，验证映射是否正确：

using (var context = new AppDbContext())
{
    // 查询所有用户
    var users = context.Users.ToList();

    // 新增用户
    var newUser = new User
    {
        Username = "johndoe",
        Email = "john@example.com"
    };
    context.Users.Add(newUser);
    context.SaveChanges();
}

关键注意事项 #

• 严格匹配数据库结构：Fluent API的配置必须与数据库表的列名、数据类型、约束完全一致，否则会出现映射错误。
• 避免自动创建数据库：确保DbContext不会自动创建数据库（默认情况下，若数据库不存在Code-First会创建，但我们已经手动创建了，所以可以在连接字符串中添加MultipleActiveResultSets=True;TrustServerCertificate=True，或者在OnConfiguring中设置optionsBuilder.UseSqlServer(..., b => b.MigrationsHistoryTable(null))来禁止迁移表创建）。
• 复杂映射处理：对于视图、存储过程、多对多关系等，可以通过Fluent API的ToView、HasMany/WithMany等方法进行配置，或者直接通过FromSqlRaw调用存储过程。

内容的提问来源于stack exchange，提问作者Ruel A Almonia