Marten库中ToPagedListAsync与Select投影查询的兼容性问题分析

问题背景

在使用Marten 7.25.1版本进行文档数据库查询时，开发人员发现了一个关于分页查询与投影查询(Select)组合使用的兼容性问题。具体表现为：当使用ToPagedListAsync()方法与Select投影结合时，返回结果中的所有属性值均为null，而单独使用ToListAsync()时却能正常获取数据。

问题复现

让我们通过代码示例来理解这个问题：

// 正常工作的情况
var folders = await _storage.Query<Folder>()
    .Select(f => new InANutshellFolder()
    {
        OperationDate = f.ClassAction.OperationDate,
        FolderIdentifier = f.Id,
    })
    .ToListAsync();

// 出现问题的情况
var folders = await _storage.Query<Folder>()
    .Select(f => new InANutshellFolder()
    {
        OperationDate = f.ClassAction.OperationDate,
        FolderIdentifier = f.Id,
    })
    .ToPagedListAsync(1, 30);

在第二个使用ToPagedListAsync的示例中，返回的InANutshellFolder对象的所有属性值都为null，而第一个使用ToListAsync的示例则能正确填充属性值。

技术分析

这个问题实际上反映了Marten在7.25.1版本中对LINQ查询处理的一个缺陷。当进行分页查询时，Marten内部生成的SQL查询可能没有正确处理投影转换(Select)后的结果映射。

在底层实现上，ToPagedListAsync需要执行两个操作：

1. 获取符合条件的数据总数(用于分页信息)
2. 获取当前页面的实际数据

问题可能出在第二步中，当处理投影后的结果时，Marten没有正确地将数据库查询结果映射到目标类型InANutshellFolder的属性上。

解决方案

根据项目维护者的回复，这个问题已经在Marten 7.26.1版本中得到修复。修复的核心在于改进了分页查询与投影查询的组合处理逻辑，确保在分页场景下也能正确执行属性映射。

最佳实践建议

1. 版本升级：遇到此类问题时，首先考虑升级到已修复该问题的版本(7.26.1或更高)。

2. 替代方案：如果暂时无法升级，可以考虑以下替代实现：

   var query = _storage.Query<Folder>()
       .Select(f => new InANutshellFolder()
       {
           OperationDate = f.ClassAction.OperationDate,
           FolderIdentifier = f.Id,
       });
   
   var total = await query.CountAsync();
   var items = await query.Skip((pageNumber - 1) * pageSize)
                         .Take(pageSize)
                         .ToListAsync();
   
   return new PagedList<InANutshellFolder>(items, pageNumber, pageSize, total);
   

3. 测试验证：在使用分页与投影组合功能时，应编写单元测试验证返回结果的正确性。

总结

这个案例展示了ORM框架中查询组合功能可能存在的边界情况。Marten作为.NET生态中优秀的文档数据库库，其维护团队对这类问题的响应速度值得肯定。开发者在遇到类似问题时，应及时检查版本更新并与社区沟通，以获得最佳解决方案。