Marten库中不同Schema下同名文档类型的处理方案

Marten是一个基于PostgreSQL的.NET文档数据库和事件存储库。在实际开发中，我们可能会遇到一个特殊场景：同一个数据库中不同Schema下存在同名文档类型的情况。本文将深入分析这一问题及其解决方案。

问题背景

在Marten 5.11.0版本中，当开发者尝试在同一个数据库的不同Schema下定义同名文档类型时，会遇到AmbiguousDocumentTypeAliasesException异常。这是因为Marten默认不允许文档类型有相同的别名(Alias)，即使它们位于不同的Schema中。

典型场景如下：

// public Schema下的文档类型
[DatabaseSchemaName("public")]
public class MaterialEntity : BaseEntity { }

// manufacturing Schema下的文档类型
[DatabaseSchemaName("manufacturing")]
public class MaterialEntity : AggregateBaseEntity { }

问题分析

Marten内部通过assertNoDuplicateDocumentAliases()方法检查文档类型别名的唯一性。该方法会抛出异常，因为它无法区分不同Schema下的同名文档类型。

解决方案演进

1. 使用不同类名（不推荐）

最简单的解决方案是修改类名，但这可能不符合业务需求，特别是当业务模型确实需要在不同上下文中使用相同名称时。

2. 使用DocumentAlias属性（有局限性）

[DatabaseSchemaName("public")]
[DocumentAlias("publicmaterial")]
public class MaterialEntity { }

这种方法会改变数据库中的实际表名（如mt_doc_publicmaterial），可能与现有生产环境不兼容。

3. 多Store模式（推荐方案）

Marten支持为不同Schema创建独立的Store实例：

// 为public Schema创建Store
builder.Services.AddMartenStore<ISynchronizationStore>(opts => {
    opts.Connection(dbConnectionString);
    opts.DatabaseSchemaName = "public";
});

// 为manufacturing Schema创建Store
builder.Services.AddMartenStore<IManufacturingStore>(opts => {
    opts.Connection(dbConnectionString);
    opts.DatabaseSchemaName = "manufacturing";
});

这种方案的优点：

• 保持原有表名不变
• 每个Schema有独立的配置
• 类型安全地访问不同Schema

4. 等待官方修复（未来方案）

Marten团队已意识到这个问题，并计划在未来版本中改进Schema感知的别名检查机制。建议开发者升级到最新版本以获得更好的支持。

最佳实践建议

1. 评估业务需求：确认是否真的需要在不同Schema下使用同名文档类型

2. 统一命名规范：如果允许修改，建立清晰的命名约定

3. 隔离访问层：为不同Schema的文档类型创建独立的仓储接口

4. 事务处理：对于跨Schema操作，考虑使用显式事务管理

5. 版本升级：定期评估Marten新版本，获取更好的Schema支持

总结

处理Marten中不同Schema下的同名文档类型需要权衡业务需求和技术限制。多Store模式目前是最佳解决方案，既能保持生产环境兼容性，又能提供类型安全的访问方式。随着Marten的持续发展，这一问题有望得到更优雅的解决。