使用Npgsql执行EF迁移时遇PostgresException:3D000数据库不存在问题

问题描述 #

使用Npgsql对PostgreSQL数据库执行EF迁移，代码如下：

var applicationContextOption = CreateContextOption<ApplicationDbContext>(connectionString, loggerFactory);

using ApplicationDbContext context = new(applicationContextOption.Options, null);
context.Database.Migrate();

习惯了context.Database.Migrate()在SQL Server中会自动创建不存在的数据库，但运行时出现错误：

PostgresException: 3D000: database "xx" does not exist.

已尝试重启VS2022、电脑，清理重建解决方案，问题依旧。

问题原因 #

EF Core的Migrate()方法在PostgreSQL环境下（Npgsql驱动），不支持自动创建不存在的目标数据库。这是PostgreSQL的机制限制：创建数据库必须先连接到一个已存在的数据库（比如默认的postgres库），无法通过连接不存在的库的连接字符串直接执行创建操作，而SQL Server没有这个限制。

解决方法 #

步骤1：先创建目标数据库，再执行迁移 #

通过连接到默认的postgres库，手动检查并创建目标数据库，之后再执行EF迁移：

// 构建连接到默认postgres库的连接字符串
var connStringBuilder = new NpgsqlConnectionStringBuilder(connectionString);
var targetDbName = connStringBuilder.Database;
// 切换到默认存在的postgres数据库
connStringBuilder.Database = "postgres";
var defaultConnString = connStringBuilder.ToString();

// 检查并创建目标数据库
using (var defaultConn = new NpgsqlConnection(defaultConnString))
{
    defaultConn.Open();
    using var checkCmd = defaultConn.CreateCommand();
    checkCmd.CommandText = $"SELECT 1 FROM pg_database WHERE datname = @dbName";
    checkCmd.Parameters.AddWithValue("@dbName", targetDbName);
    var dbExists = checkCmd.ExecuteScalar() != null;

    if (!dbExists)
    {
        using var createCmd = defaultConn.CreateCommand();
        // 注意PostgreSQL数据库名如果有特殊字符需要用双引号包裹
        createCmd.CommandText = $"CREATE DATABASE \"{targetDbName}\"";
        createCmd.ExecuteNonQuery();
    }
}

// 执行EF迁移
var applicationContextOption = CreateContextOption<ApplicationDbContext>(connectionString, loggerFactory);
using ApplicationDbContext context = new(applicationContextOption.Options, null);
context.Database.Migrate();

注意事项 #

• 确保执行代码的数据库账号拥有CREATEDB权限，否则会抛出权限不足的错误。
• 连接字符串中的账号需要能够访问默认的postgres数据库。
• 如果目标数据库已经存在，上述代码会跳过创建步骤，直接执行迁移。

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