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 覆盖)-
单表指定(灵活应对混合场景)
modelBuilder.Entity
().ToTable("Orders", "sales"); modelBuilder.Entity ().ToTable("Users", "auth"); ✅ 精确控制每张表归属
✅ 适合跨业务域共存的复杂库
❌ 表多时易漏配、难维护 -
数据注解(适合简单、静态模型)
[Table("Products", Schema = "inventory")] public class Product { ... }✅ 写法直观,贴近实体定义
✅ 不依赖 DbContext 配置逻辑
❌ 无法动态切换;不支持条件判断;部分高级配置(如计算列、函数映射)必须用 Fluent API
实际使用注意点
-
HasDefaultSchema必须在OnModelCreating中调用,且早于任何Entity,否则会被后者覆盖.ToTable() - 如果同时用了
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) 微调,是多数项目的稳妥选择。










