Marten数据库初始化问题解析：控制台应用中如何正确创建PostgreSQL数据库

问题背景

在使用Marten（一个基于PostgreSQL的.NET文档数据库库）时，开发者可能会遇到一个常见问题：在控制台应用程序中配置了数据库创建选项，但实际运行时数据库并未被创建。这个问题通常出现在从Marten 5升级到7版本后，或者在新建的控制台应用项目中。

问题现象

开发者按照官方文档配置了Marten，设置了CreateDatabasesForTenants选项，期望在应用启动时自动创建数据库。然而运行时却收到错误提示："database does not exist"，表明数据库创建并未按预期执行。

问题根源分析

经过深入研究发现，这个问题源于Marten 7.x版本的工作机制变化。在控制台应用中，Marten的数据库初始化逻辑依赖于.NET Core的IHostedService机制。然而，简单的AddMarten()调用并不会自动注册数据库初始化的后台服务。

解决方案

正确的配置方式需要显式启用数据库变更应用功能。以下是完整的解决方案代码示例：

const string connectionString = "Host=localhost;Database=db_1;Username=pgu;Password=pgp;";

var builder = Host.CreateApplicationBuilder();

builder.Services
    .AddMarten(options =>
    {
        options.Connection(connectionString);
        options.CreateDatabasesForTenants(x =>
        {
            x.ForTenant()
                .WithOwner("postgres")
                .WithEncoding("UTF-8")
                .ConnectionLimit(-1);
        });
    })
    .ApplyAllDatabaseChangesOnStartup();  // 关键配置项

using var host = builder.Build();
await host.StartAsync();

using var store = host.Services.GetRequiredService<IDocumentStore>();
await using var session = store.LightweightSession();
await session.QueryAsync<int>("select 1");

关键点说明

1. ApplyAllDatabaseChangesOnStartup()：这个方法是解决问题的关键，它会注册必要的后台服务来执行数据库初始化工作。

2. Host构建：必须使用.NET Core的Host构建模式，这是Marten初始化机制的基础。

3. 启动顺序：确保在获取DocumentStore实例前调用host.StartAsync()，这样数据库初始化才能完成。

深入理解

Marten 7.x的设计更加模块化，将数据库初始化等功能设计为可选组件。这种设计提高了灵活性，但也要求开发者明确指定需要的功能。ApplyAllDatabaseChangesOnStartup()方法实际上会注册一个IHostedService，在应用启动时执行数据库变更。

最佳实践建议

1. 对于生产环境，考虑使用专门的数据库迁移工具（如Flyway或DbUp）来管理数据库变更。

2. 在测试环境中，可以结合DropExisting(true)选项确保每次测试都有干净的数据库环境。

3. 对于复杂的多租户场景，仔细规划数据库创建策略，包括权限设置和连接限制。

总结

Marten作为一个强大的文档数据库库，在版本演进中不断优化其架构设计。理解其初始化机制的变化，能够帮助开发者更好地利用其功能。记住在控制台应用中使用Marten时，必须显式调用ApplyAllDatabaseChangesOnStartup()来确保数据库正确初始化，这是从Marten 5升级到7后需要特别注意的变化点。