EF Core 6中AppDbContext的OnModelCreating未触发，HasDefaultSchema无效

1. 确认DbContext方法定义正确性 #

确保AppDbContext正确继承自DbContext，且OnModelCreating方法使用protected override修饰符，同时不要遗漏调用基类方法：

public class AppDbContext : DbContext
{
    public AppDbContext(DbContextOptions<AppDbContext> options) : base(options) { }

    protected override void OnModelCreating(ModelBuilder modelBuilder)
    {
        base.OnModelCreating(modelBuilder); // 必须调用基类方法，确保默认配置加载
        modelBuilder.HasDefaultSchema("YourSchemaName");
        // 其他实体配置逻辑
    }
}

若方法修饰符错误（如写成private）或未调用基类方法，会导致自定义配置不生效。

2. 检查DbContext依赖注入注册 #

在Program.cs（.NET 6+）或Startup.cs中，确保正确注册AppDbContext，避免使用基类DbContext作为注册类型：

// .NET 6+ Program.cs 示例
builder.Services.AddDbContext<AppDbContext>(options =>
    options.UseSqlServer(builder.Configuration.GetConnectionString("DefaultConnection")));

若注册时使用AddDbContext<DbContext>，EF Core会使用默认DbContext实例而非自定义的AppDbContext，自然不会触发OnModelCreating。

3. 排查实体类Schema显式配置冲突 #

检查所有实体类是否使用[Table]属性显式指定了Schema：

// 这种显式配置会覆盖全局的HasDefaultSchema设置
[Table("Products", Schema = "OtherSchema")]
public class Product { }

如果存在此类配置，全局默认Schema会被实体级配置覆盖，需统一调整或移除实体上的Schema指定。

4. 验证DbContext实例获取方式 #

确保代码中通过依赖注入获取AppDbContext实例，而非手动new未配置的实例：

// 正确方式：通过构造函数注入
public class ProductService
{
    private readonly AppDbContext _dbContext;
    public ProductService(AppDbContext dbContext)
    {
        _dbContext = dbContext;
    }
}

手动new AppDbContext()会绕过依赖注入配置，导致OnModelCreating不被调用。

5. 启用EF Core日志排查问题 #

添加日志输出，查看EF Core模型构建阶段的详细日志，确认OnModelCreating是否被执行：

// .NET 6+ Program.cs 中添加日志配置
builder.Logging.AddFilter("Microsoft.EntityFrameworkCore", LogLevel.Debug);

运行程序后，查看日志中是否包含ModelBuilder相关调试信息，若没有则说明AppDbContext未被正确初始化。

内容的提问来源于stack exchange，提问作者Muhammadabdulloh Komilov