RavenDB 6/7中Id属性投影问题的解决方案

问题背景

在从RavenDB 5升级到6或7版本时，开发人员可能会遇到一个关于文档Id属性投影的兼容性问题。当使用LINQ查询进行文档投影时，如果将文档的Id属性映射到视图模型的不同名称属性上，在RavenDB 6及以上版本中，该属性可能会返回null值。

问题重现

典型的查询模式如下：

var query = session.Query<TestDocumentByName.Query, TestDocumentByName>()
    .Where(x => x.Name == "Jon")
    .As<TestDocument>();

var transform = from r in query
    let another = RavenQuery.Load<AnotherDocument>(r.AnotherDocumentId)
    select new TestViewModel
    {
        TestDocumentId = r.Id,  // 在RavenDB 6/7中会返回null
        Name = r.Name,
        AnotherDocumentId = another.Id,
        AnotherName = another.Name
    };

根本原因

在RavenDB 6中引入了一个重要的API变更。直接访问文档的Id属性(r.Id)在投影操作中不再有效，这是为了提供更明确的语义和更好的性能优化。

解决方案

正确的做法是使用RavenQuery.Id()方法来显式获取文档ID：

TestDocumentId = RavenQuery.Id(r),

这个变更虽然带来了轻微的代码修改需求，但它提供了以下优势：

1. 更明确的语义：清楚地表明这是在获取RavenDB文档ID
2. 更好的性能：优化了查询执行计划
3. 更强的类型安全：减少了潜在的错误

迁移建议

对于从RavenDB 5升级的项目，建议：

1. 全局搜索所有.Select()投影中的.Id引用
2. 替换为RavenQuery.Id()调用
3. 特别注意嵌套投影和复杂查询中的ID引用

总结

RavenDB 6/7中的这一变更虽然带来了短暂的迁移成本，但提高了代码的清晰度和查询效率。理解这一变更背后的设计理念有助于开发者更好地利用RavenDB的特性构建健壮的应用程序。

对于新项目，建议从一开始就采用RavenQuery.Id()的标准用法，以避免后续的兼容性问题。