在.NET 5.0中使用NEST如何设置Elasticsearch查询默认返回记录数？

问题根源 #

Elasticsearch原生搜索请求默认的size参数值为10，未手动指定的情况下最多只返回10条数据，NEST作为官方.NET客户端默认遵循该规则。

实现方案 #

方案1：客户端初始化时全局配置（推荐） #

适配NEST 7.x及以上版本，可直接在ConnectionSettings中通过前置请求钩子统一配置，该配置不会覆盖单次查询手动指定的Size值：

var settings = new ConnectionSettings(new Uri("你的Elasticsearch服务地址"))
    .DefaultIndex("你的默认索引名称")
    // 全局配置所有搜索请求默认返回条数，示例设置为100，可根据业务调整
    .PreDispatch<ISearchRequest>(req => 
    {
        req.Size ??= 100;
    });

// 初始化后的客户端所有搜索请求都会自动携带默认Size
var elasticClient = new ElasticClient(settings);

方案2：仓储层封装统一配置 #

如果你的项目已经封装了自定义Elasticsearch仓储层（如你示例中用到的_repositoryProcessResumeElastic），可直接在查询方法中统一添加默认逻辑：

public class ElasticRepository<T> where T : class
{
    private readonly IElasticClient _elasticClient;

    public ElasticRepository(IElasticClient elasticClient)
    {
        _elasticClient = elasticClient;
    }

    public async Task<ISearchResponse<T>> SearchAsync(Func<SearchDescriptor<T>, ISearchRequest> selector = null)
    {
        selector ??= d => d;
        return await _elasticClient.SearchAsync<T>(d => 
        {
            var request = selector(d);
            // *手动设置的Size优先级更高，未设置时才用默认值*
            request.Size ??= 100;
            return request;
        });
    }
}

注意事项 #

• Elasticsearch默认限制from + size的总和不能超过索引参数index.max_result_window的默认值10000，超过会抛出异常，因此全局size不要设置过大。如果需要查询超10000条的批量数据，建议使用Scroll或Search After接口。
• 单次查询如果有特殊返回条数需求，直接调用.Size()方法手动指定即可，手动设置的优先级高于全局默认配置。

内容的提问来源于stack exchange，提问作者Henrique Mauri