Match搜不到中文主因是未配中文分词器、字段映射错误及未设BasicAuthentication；standard分词器按字切词导致匹配失败，须用ik_smart等分词器并确保字段为text类型、大小写一致、非空查询，且ES 8.x需配置HTTPS与认证。
直接用 Match 搜中文基本没结果，不配分词器、不检查字段映射、不设 BasicAuthentication，90% 的“搜不到”问题都出在这三步里。
为什么 Match 搜不到中文？
ES 默认的 standard 分词器对中文是“按字切”，“北京”会被切成 [“北”, “京”]，而用户搜“北京市”时根本匹配不上。必须显式指定中文分词器（如 ik_smart），且字段类型得是 text（不是 keyword）。
- 确认索引 mapping 中目标字段用了
[Text(Analyzer = "ik_smart")]特性（NEST 8.x）或在 Kibana 执行GET /your-index/_mapping查看实际 analyzer - 字段名大小写必须完全一致：C# 属性叫
ProductName，mapping 里也得是"productname"或"ProductName"（取决于你是否开了DefaultFieldNameInferrer） - 别在
Match查询里传空字符串或只含空白符的Query值，ES 会静默返回 0 条结果
NEST 8.x 连接 ES 8.x 必须配 BasicAuthentication
ES 8.x 默认启用安全模块，ConnectionSettings 不设认证凭据，请求直接卡在 401 Unauthorized，连错误堆栈都看不到——因为连接层就失败了。
- 初始化时必须写：
.BasicAuthentication("elastic", "your-password")（用户名密码要和elasticsearch.yml里xpack.security.authc.api_key.enabled: true等配置匹配） - URI 必须带协议：
new Uri("https://localhost:9200")，写成"localhost:9200"或漏掉https://都会抛UriFormatException - 本地开发若用 HTTP，需在
elasticsearch.yml关掉 TLS：xpack.security.http.ssl.enabled: false，否则必须用 HTTPS + 证书
SearchDescriptor 写法错一个字母就静默失败
NEST 8.x 对泛型和链式调用更严格，.Field(f => f.Name) 写成 .Field("name") 可能编译通过但运行时查不到；From(0).Size(10) 少个括号或参数类型错，整个查询就退化成 match_all。
- 永远用强类型字段访问：
.Field(f => f.ProductName)，别用字符串硬编码字段名 -
Match和Term别混用：Term是精确匹配 keyword 字段，“北京”搜不出“北京市”；Match才走分词，适合 text 字段 - 调试时加
.Explain(true)，返回结果里会有_explanation字段，能看出为什么某文档没被匹配上
批量写入性能差十倍？别循环调 Index()
单条 Index() 调用对应一次 HTTP 请求，网络开销远大于数据本身。1000 条数据循环调用，吞吐可能只有批量 Bulk() 的 1/10。
- 用
client.Bulk(b => b.IndexMany(yourList))，一次请求提交多条文档 - 避免在
Bulk()外层再套foreach分批——NEST 内部已做流式处理，传入 List即可 - 如果 Bulk 报错，检查
response.Errors而不是只看IsValid，部分失败时IsValid仍为 true
最常被跳过的其实是 mapping 验证和分词器测试——先在 Kibana Console 里用 POST /your-index/_analyze 手动跑一遍分词，再写 C# 代码，能省掉大半排查时间。
