Marten项目中的乐观并发控制变更解析

背景介绍

Marten是一个基于PostgreSQL的.NET文档数据库和事件存储库。在最新发布的7.5.0版本中，Marten对乐观并发控制机制进行了重要变更，这可能会影响现有系统的升级过程。

乐观并发控制机制的变化

在Marten 6.4.1及之前版本中，系统支持两种乐观并发控制方式：

1. 基于GUID的版本控制（传统方式）
2. 基于数值的版本控制（新方式）

然而在7.5.0版本中，Marten团队做出了一个重要决定：不再支持将GUID版本控制用于任何作为投影聚合的文档类型。这一变更主要是为了支持蓝绿部署场景，因为数值版本控制在这种部署模式下是必需的。

变更影响分析

对于使用以下配置组合的现有系统：

1. 使用ProjectionLifecycle.Inline内联投影
2. 同时启用了UseOptimisticConcurrency(true)（即GUID版本控制）

在升级到7.5.0版本时会遇到问题。系统会抛出ArgumentException异常，提示"mt_version"键已存在，导致应用中断。

解决方案

对于遇到此问题的用户，建议采取以下步骤进行迁移：

1. 移除GUID版本控制：从文档配置中删除UseOptimisticConcurrency(true)调用
2. 允许自动迁移：Marten会自动将mt_version列从GUID类型迁移为整数类型
3. 测试验证：确保系统在数值版本控制下正常工作

技术考量

这一变更背后的技术原因包括：

• 数值版本控制更适合蓝绿部署场景
• 简化了版本控制机制的统一性
• 提高了系统在分布式环境下的可靠性

最佳实践建议

对于新项目：

• 直接使用默认的数值版本控制
• 无需显式配置乐观并发控制，除非有特殊需求

对于现有项目升级：

• 在开发环境先测试升级过程
• 准备数据迁移方案
• 考虑在低峰期执行生产环境升级

总结

Marten 7.5.0对乐观并发控制机制的变更反映了项目向更稳定、更适合现代部署模式的方向发展。虽然这一变更可能会给部分现有系统带来升级挑战，但从长远来看，统一使用数值版本控制将提高系统的可靠性和可维护性。开发者在升级时应充分了解这一变更，并做好相应的迁移准备。