match查不到中文主因是未配中文分词器、字段映射错误及未设basicauthentication；es默认standard分词器按字切分，需显式指定ik_smart等分词器并确保字段为text类型、大小写一致、禁用空查询。
直接用 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 条结果
ElasticClient 初始化失败的常见原因
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 请求，网络开销远大于数据本身。
- 批量写入用
client.Bulk()，别循环调Index()，否则吞吐掉 10 倍以上 - 索引名必须全小写，ES 8+ 不接受大写字母，
Nest默认会转，但自定义名要手动检查 - 字段映射要用
[Text(Analyzer = "ik_smart")]这类特性标注，否则中文分词器不生效
最常被忽略的是：ES 8.x 的 index 名、字段名、分词器名、认证凭据这四者，任意一个大小写或拼写错，都会导致“无报错但无结果”。调试前先用 Kibana 直接发一次 POST /your-index/_search，确认底层能跑通，再回来看 C# 代码。
