如何在EF Core（Pomelo.MySQL）中实现查询式全文搜索游标分页

1. 配置全文索引 #

首先给需要全文搜索的字段配置MySQL全文索引，以实体Article为例，假设要搜索Title和Content字段：

protected override void OnModelCreating(ModelBuilder modelBuilder)
{
    modelBuilder.Entity<Article>()
        .HasIndex(a => new { a.Title, a.Content })
        .HasMethod("FULLTEXT");
}

2. 定义游标参数类 #

因为排序依赖相关性分数+唯一ID（避免同分数行排序混乱），游标需要包含这两个值：

public class SearchCursor
{
    public double? LastRelevanceScore { get; set; }
    public int? LastId { get; set; }
}

3. 实现游标分页查询逻辑 #

通过EF.Functions.MatchAgainst计算相关性分数，结合游标实现分页：

public async Task<List<ArticleDto>> SearchArticlesAsync(string query, int pageSize, SearchCursor cursor = null)
{
    var queryable = _context.Articles
        // 计算相关性分数并关联原实体
        .Select(a => new
        {
            Article = a,
            RelevanceScore = EF.Functions.MatchAgainst(
                new[] { a.Title, a.Content },
                query,
                MySqlMatchAgainstMode.NaturalLanguage)
        })
        // 游标过滤：仅取分数小于上页最后分数，或分数相等但ID更大的行
        .Where(result => cursor == null ||
            (result.RelevanceScore < cursor.LastRelevanceScore) ||
            (result.RelevanceScore == cursor.LastRelevanceScore && result.Article.Id > cursor.LastId))
        // 稳定排序：先按分数降序，再按ID升序
        .OrderByDescending(result => result.RelevanceScore)
        .ThenBy(result => result.Article.Id)
        .Take(pageSize)
        // 映射到DTO并保留游标所需字段
        .Select(result => new ArticleDto
        {
            Id = result.Article.Id,
            Title = result.Article.Title,
            Content = result.Article.Content,
            RelevanceScore = result.RelevanceScore
        });

    var articles = await queryable.ToListAsync();

    // 若返回数据量等于页大小，生成下一页游标（可返回给前端）
    if (articles.Count == pageSize)
    {
        var lastItem = articles.Last();
        var nextCursor = new SearchCursor
        {
            LastRelevanceScore = lastItem.RelevanceScore,
            LastId = lastItem.Id
        };
        // 可将nextCursor通过响应头或返回对象传递给前端
    }

    return articles;
}

关键注意事项 #

• 排序稳定性：必须加入唯一ID作为次要排序条件，否则同分数的行在分页时会出现重复或遗漏。
• 游标传递：前端需将游标（分数+ID）作为参数传给下一页接口，可直接作为查询参数或Base64编码后传递。
• 搜索模式：可根据需求替换MySqlMatchAgainstMode枚举值，比如Boolean模式支持布尔搜索语法。
• 性能保障：全文索引已配置的情况下，MATCH() AGAINST()会利用索引大幅提升查询效率。

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