Elasticsearch通配符搜索返回全部文档问题排查（NEST）

一、通配符搜索返回全部文档的原因及修复 #

核心问题是映射字段与数据同步逻辑不匹配，导致keyword字段未被正确赋值：

1. 从索引创建代码来看，你定义了textAyeKeyword这个keyword类型字段，但数据同步时，仅给TextAyeForSearch属性赋值，未对应到textAyeKeyword字段。如果Ayah实体类中没有TextAyeKeyword属性，或者属性名与映射字段名不对应，会导致所有文档的textAyeKeyword字段为空。
2. 当用*بسم*搜索空字段时，通配符*会匹配空字符串，因此返回全部文档。

修复步骤： #

方案1：调整实体类与同步代码

在Ayah类中添加对应属性，同步时赋值：

// Ayah实体类新增属性
public string TextAyeKeyword { get; set; }

// 数据同步时为keyword字段赋值
ayahList.Add(new Ayah
{
    TextAye = textAye,
    TextAyeKeyword = textAye
});

方案2：修改索引映射匹配现有实体类

如果想保留TextAyeForSearch属性，修改映射将其设为keyword类型：

var response = _client.Indices.Create("ayah_index", c => c
    .Map<Ayah>(m => m
        .Properties(p => p
            .Text(t => t.Name(n => n.TextAye))
            .Keyword(k => k.Name(n => n.TextAyeForSearch)) // 对应实体类的TextAyeForSearch
        )
    )
);

完成后重新同步全部数据到Elasticsearch，确保keyword字段有正确内容。

二、精确搜索الله无结果的原因及修复 #

这是因为默认的standard分析器不适合阿拉伯语，会将الله错误拆分（比如拆成ال和له），导致搜索的完整词汇与索引中的分词结果不匹配。

修复步骤： #

1. 为文本字段指定阿拉伯语分析器

创建索引时，给TextAye字段配置Elasticsearch内置的arabic分析器，同时保留keyword子字段用于精确匹配：

var response = _client.Indices.Create("ayah_index", c => c
    .Map<Ayah>(m => m
        .Properties(p => p
            .Text(t => t
                .Name(n => n.TextAye)
                .Analyzer("arabic") // 使用阿拉伯语专用分析器
                .Fields(f => f.Keyword(k => k.Name("keyword"))) // 用于精确匹配的子字段
            )
        )
    )
);

2. 精确搜索使用keyword子字段

用term查询针对textAye.keyword子字段搜索，避免分词影响：

// NEST代码示例
var searchResponse = _client.Search<Ayah>(s => s
    .Query(q => q
        .Term(t => t.TextAye.Suffix("keyword"), "الله")
    )
);

或者REST API：

{
    "query": {
        "term": {
            "textAye.keyword": "الله"
        }
    }
}

验证方法 #

用以下API查询文档，确认字段内容是否正确：

GET ayah_index/_search
{
    "query": { "match_all": {} },
    "_source": ["textAye", "textAyeKeyword", "textAye.keyword"]
}

如果目标字段为空，说明数据同步环节存在问题，需再次检查实体类与映射的对应关系。

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