RavenDB 5.3 如何编写返回任意文档类型属性子集的C#泛型方法

需要实现一个C#泛型方法，依托通用BasicObject类返回指定RavenDB文档类型的精简查询结果，结果仅保留Id与string类型的Description属性（绝大多数业务文档类型本身自带这两个属性）。
方法要求支持传入投影表达式，用于将原文档类型转换为仅包含Id、Description的BasicObject实例，直接在查询的.Select()阶段完成投影，避免拉取全量文档字段。
初始实现代码如下，但RavenDB无法识别其中的表达式逻辑，需要确认该需求是否可通用实现，还是必须为每个文档类型单独编写方法：

public Task<List<T>> GetAllDocs(Expression<Func<T, BasicObject>> convertExpression)
{
    var query = _session.Query<T>
        .Select(doc => convertExpression(doc));

    var results = await query.ToListAsync();

    return results;
}

代码无法被RavenDB识别的核心原因有两个：

• Select中使用doc => convertExpression(doc)的写法属于嵌套表达式包装，RavenDB的LINQ提供器只能将其识别为一个未知的方法调用，无法穿透外层Lambda获取你实际传入的convertExpression的内部投影逻辑，自然无法翻译成可在服务端执行的RavenQL投影语句。
• 方法签名存在错误：投影后返回的是BasicObject类型列表，但签名写的是返回List<T>（原文档类型），存在类型不匹配问题。

不需要为每个文档类型单独实现方法，直接将传入的投影表达式透传给Select方法即可，修正后的代码如下：

// 修正泛型参数定义、返回值类型，去掉多余的Lambda包装
public async Task<List<BasicObject>> GetAllDocs<T>(Expression<Func<T, BasicObject>> convertExpression)
{
    var results = await _session.Query<T>()
        .Select(convertExpression) // 直接传入表达式，不做嵌套包装
        .ToListAsync();
    return results;
}

调用时直接传入对应类型的投影逻辑即可，RavenDB可以正常解析该写法，直接在服务端完成投影，不会拉取多余字段：

// 调用示例
var productItems = await GetAllDocs<Product>(doc => new BasicObject
{
    Id = doc.Id,
    Description = doc.Description
});

可选优化 #

如果所有业务文档类型都固定包含Id和Description属性，可以通过接口约束进一步简化调用，不需要每次传入投影表达式：

1. 先定义公共约束接口

public interface IStandardDoc
{
    string Id { get; set; }
    string Description { get; set; }
}

2. 让所有符合规则的文档类型实现该接口，将泛型方法改写为约束版本：

public async Task<List<BasicObject>> GetAllDocs<T>() where T : IStandardDoc
{
    var results = await _session.Query<T>()
        .Select(doc => new BasicObject
        {
            Id = doc.Id,
            Description = doc.Description
        })
        .ToListAsync();
    return results;
}

该写法的执行效率和为每个文档类型单独写查询的表现完全一致，RavenDB可以正常解析表达式完成服务端投影。

内容的提问来源于stack exchange，提问作者Chris Fellows