Marten 项目中 DateOnly 类型字段索引创建问题解析

问题背景

在 Marten 6.4.1 版本中，开发者在尝试为包含 DateOnly 类型字段的实体类创建索引时遇到了问题。当使用 SchemaBuilder 为 DateOnly 类型字段创建索引时，系统会抛出 PostgreSQL 特有的错误："functions in index expression must be marked IMMUTABLE"。

技术细节分析

DateOnly 是 .NET 6 引入的新类型，用于表示仅包含日期部分的值（不包含时间）。Marten 在处理这种类型时，尝试将其映射到 PostgreSQL 的 date 类型，但在创建索引时遇到了函数可变性问题。

错误的核心在于 PostgreSQL 要求索引表达式中的函数必须是 IMMUTABLE（不可变的），这意味着函数对于相同的输入必须始终返回相同的输出，不能依赖于数据库状态或外部因素。Marten 生成的 CAST 转换函数未被标记为 IMMUTABLE，因此 PostgreSQL 拒绝了索引创建请求。

临时解决方案

在官方修复此问题之前，开发者可以采用以下临时解决方案：

1. 使用重复字段(Duplicate Field)：通过配置将 DateOnly 字段标记为重复字段，这样 Marten 会在文档表中创建一个额外的列来存储该值，可以直接在该列上创建索引。

_.Schema.For<SampleClass>()
    .Duplicate(c => c.Date);

2. 自定义索引表达式：通过编写自定义的 SQL 表达式来创建索引，确保使用的转换函数是 IMMUTABLE 的。

官方修复情况

Marten 开发团队已经确认了这个问题，并在本地环境中完成了修复。修复方式可能是为 DateOnly 类型实现类似 DateTime 类型的处理机制，确保生成的索引表达式符合 PostgreSQL 的 IMMUTABLE 要求。

性能考量

虽然使用重复字段可以解决索引问题，但需要注意以下几点：

1. 写入性能：重复字段会增加写入时的开销，因为 Marten 需要同时更新文档的 JSON 数据和单独的列。
2. 存储空间：每个重复字段都会在表中创建额外的列，增加存储需求。
3. 查询灵活性：JSON 查询和重复字段查询在性能特征上有所不同，需要根据实际查询模式进行选择。

最佳实践建议

对于生产环境中的 DateOnly 类型字段处理，建议：

1. 如果升级到包含修复的 Marten 版本是可行的选择，等待官方发布修复版本是最佳方案。
2. 如果必须立即解决，评估使用重复字段对应用性能的影响，特别是在写入密集场景下。
3. 考虑业务需求，评估是否真的需要在该字段上创建索引，或者是否有其他查询优化方式。

随着 .NET 生态中 DateOnly 类型使用越来越广泛，Marten 对其的完整支持将变得更加重要，开发团队对此问题的快速响应也体现了项目的活跃维护状态。