如何阻止Entity Framework Code First执行'CREATE SCHEMA IF NOT EXISTS'

背景 #

你的场景中使用权限受限的PostgreSQL账号，该账号仅能创建表、视图等对象但无法创建Schema，而EF Core在执行dotnet ef database update时会自动尝试创建默认Schema，导致执行报错。以下是几种可行的解决方式：

方法1：手动清理迁移文件中的Schema创建代码 #

每次生成新迁移后，打开对应的迁移文件，删除Up()方法中自动生成的创建Schema语句：

// 迁移文件中自动生成的代码，直接删除此行
migrationBuilder.CreateSchema(name: "supermarkets_schema");

注意：每次新增迁移都需要重复此操作，适合迁移频率较低的场景。

方法2：通过Npgsql配置禁用自动创建Schema #

在配置DbContext时，添加Npgsql的选项设置，禁用自动创建Schema的行为：
修改DatabaseContextFactory的代码：

public DatabaseContext CreateDbContext(string[] args)
{
    var optionsBuilder = new DbContextOptionsBuilder<DatabaseContext>();
    optionsBuilder.UseNpgsql(
        "你的数据库连接字符串",
        x => 
        {
            x.MigrationsHistoryTable(HistoryRepository.DefaultTableName, Constants.SchemaName);
            // 禁用自动创建Schema
            x.DisableAutomaticSchemaCreation();
        });

    return new DatabaseContext(optionsBuilder.Options);
}

如果是在Startup/Program类中配置DbContext，同样添加该选项：

services.AddDbContext<DatabaseContext>(options =>
    options.UseNpgsql(Configuration.GetConnectionString("YourConnStr"), 
        x => x.DisableAutomaticSchemaCreation()));

方法3：自定义迁移SQL生成器拦截Schema创建操作 #

通过自定义Npgsql的迁移SQL生成器，彻底跳过创建Schema的语句：

1. 实现自定义生成器：

using Microsoft.EntityFrameworkCore.Migrations;
using Npgsql.EntityFrameworkCore.PostgreSQL.Migrations;

public class CustomNpgsqlMigrationSqlGenerator : NpgsqlMigrationSqlGenerator
{
    public CustomNpgsqlMigrationSqlGenerator(
        MigrationSqlGeneratorDependencies dependencies, 
        INpgsqlOptions npgsqlOptions)
        : base(dependencies, npgsqlOptions)
    {
    }

    protected override void Generate(CreateSchemaOperation operation)
    {
        // 空实现，跳过创建Schema的操作
    }
}

2. 在DbContext中注册自定义服务：

protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
{
    optionsBuilder.ReplaceService<IMigrationSqlGenerator, CustomNpgsqlMigrationSqlGenerator>();
}

或者在服务配置中注册：

services.AddDbContext<DatabaseContext>(options =>
{
    options.UseNpgsql(Configuration.GetConnectionString("YourConnStr"));
    options.ReplaceService<IMigrationSqlGenerator, CustomNpgsqlMigrationSqlGenerator>();
});

必要前提 #

无论使用哪种方案，必须提前用拥有Schema创建权限的账号在数据库中创建好目标Schema：

CREATE SCHEMA supermarkets_schema;

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