EF Core怎么处理数据库架构(Schema) EF Core HasDefaultSchema配置

EF Core 中默认 Schema 因数据库而异：sql Server 为 dbo，postgresql 为 public，sqlite/mysql 不支持；推荐优先使用 HasDefaultSchema 全局配置，再以 Totable 按需微调。

EF Core 处理数据库架构（Schema）的核心在于明确指定表所属的命名空间，尤其在 SQL Server、PostgreSQL 等支持多 Schema 的数据库中，这直接影响表的创建位置、查询路径和权限管理。默认行为因数据库而异，不能依赖“自动正确”。

HasDefaultSchema 是最常用也最省力的全局配置方式，它作用于整个模型，避免为每个实体重复写 schema 名。

默认 Schema 是什么？看数据库类型

• SQL Server：默认是 dbo
• PostgreSQL：默认是 public
• SQLite / MySQL：不支持 Schema 概念（忽略该配置）

如果你没显式设置，EF Core 会按数据库约定走。但一旦项目需要隔离环境（如 dev/test/prod 各用不同 schema），或团队规范要求统一前缀（如 sales.、auth.），就必须主动干预。

三种指定 Schema 的方式，按推荐顺序

• 全局默认（推荐用于统一架构）
  在 OnModelCreating 中调用 modelBuilder.HasDefaultSchema("sales")
  ✅ 所有未单独指定 schema 的实体，都会落到 sales 下
  ✅ 一处配置，全模型生效，不易遗漏
  ❌ 无法对个别表做例外处理（需配合 ToTable 覆盖）

• 单表指定（灵活应对混合场景）

  

  Tellers AI

  Tellers是一款自动视频编辑工具，可以将文本、文章或故事转换为视频。

  136

  查看详情

  modelBuilder.Entity<Order>().ToTable("Orders", "sales"); modelBuilder.Entity<User>().ToTable("Users", "auth");

  ✅ 精确控制每张表归属
  ✅ 适合跨业务域共存的复杂库
  ❌ 表多时易漏配、难维护

• 数据注解（适合简单、静态模型）

  [Table("Products", Schema = "inventory")] public class Product { ... }

  ✅ 写法直观，贴近实体定义
  ✅ 不依赖 DbContext 配置逻辑
  ❌ 无法动态切换；不支持条件判断；部分高级配置（如计算列、函数映射）必须用 Fluent API

实际使用注意点

• HasDefaultSchema 必须在 OnModelCreating 中调用，且早于任何 Entity<t>.ToTable()</t>，否则会被后者覆盖
• 如果同时用了 ToTable("name", "schema") 和 HasDefaultSchema("other")，以 ToTable 的 schema 为准
• 迁移生成（dotnet ef migrations add）时，schema 信息会写入迁移代码，影响 Up/Down 方法中的 CREATE TABLE 语句
• 使用 EnsureCreated() 或 Migrate() 时，EF Core 会自动创建 schema（如 SQL Server 的 CREATE SCHEMA sales），前提是数据库用户有相应权限

基本上就这些。用 HasDefaultSchema 打底 + 少量 ToTable(..., schema) 微调，是多数项目的稳妥选择。