当前c#连接elasticsearch最省心、可维护性最强的方案是nest或elastic.clients.elasticsearch，前提是版本匹配、认证正确、索引准确；nest适合强类型映射和复杂查询但需严格对齐es主版本，elastic.clients是官方8.x+主推新客户端，默认system.text.json且不支持特性自动生成mapping。
直接用 NEST 或 Elastic.Clients.Elasticsearch 连 Elasticsearch 是当前 C# 里最省心、可维护性最强的全文搜索方案——前提是版本对得上、认证配得对、索引建得准，否则连 401 Unauthorized 都可能卡半天。
怎么选客户端：NEST 还是 Elastic.Clients？
不是“哪个更好”，而是“哪个不翻车”：
-
NEST适合已有项目或需要强类型映射（比如用[Text(Analyzer = "ik_smart")]标字段）、复杂查询构建的场景；但必须严格匹配 Elasticsearch 主版本，例如 ES 8.12.0 → 必须用NEST 8.12.0，否则抛Invalid NEST response built from a unsuccessful low level call -
Elastic.Clients.Elasticsearch是官方 8.x+ 主推的新客户端，不依赖Newtonsoft.Json，默认用System.Text.Json；但它不支持自动从特性生成 mapping，字段类型得靠索引模板或PutIndexTemplate显式定义 - 别用
Elasticsearch.Net直接裸调，除非你在封装 SDK 或调试协议层；它要求手动拼 URL 和PostData，连个match查询都得写成new { query = new { match = new { title = "test" } } } - 手写
HttpClient仅限临时验证或极轻量脚本，上线项目请立刻放弃
连接失败常见原因：401 / 403 / Connection refused
ES 8.x 默认启用安全认证和 HTTPS，90% 的连接失败源于配置漏项：
- URL 必须带协议：
https://localhost:9200，写成http://或漏掉端口会直接Connection refused - 没配认证信息：ES 8.x 启动后默认要
BasicAuthentication，new BasicAuthentication("elastic", "password")必须传进ConnectionSettings或ElasticsearchClient构造函数 - 证书问题：本地开发若用自签名证书，
NEST需加.ServerCertificateValidationCallback((_, _, _, _) => true)；Elastic.Clients则需注入自定义HttpClientHandler - 索引名含大写字母：ES 8+ 索引名强制小写，
MyIndex会报invalid index name，Nest 默认转小写，但自定义名务必手动检查
中文搜不到？分词器和字段映射是关键
默认 StandardAnalyzer 对中文是“字面切分”，搜“北京市”基本匹配不到任何内容：
- 字段必须显式指定中文分词器：用
[Text(Analyzer = "ik_smart")]（需先在 ES 安装 IK 插件）或[Text(Analyzer = "jieba_search")] - mapping 必须在首次创建索引时生效；改字段类型需重建索引，
PUT /my-index/_mapping不能改已存在字段的 analyzer - 查询别手写
TermQuery：要用MatchQuery或QueryStringQuery，否则不走分词流程；Match("title", "北京")才能命中 “北京市” - 测试分词效果：用 Kibana 的
Dev Tools执行GET /my-index/_analyze?analyzer=ik_smart&text=北京市，确认输出是["北京", "市"]而非["北","京","市"]
数据写入后搜不到？Commit 和刷新机制没搞清
ES 不是“写完立刻可搜”，默认 1 秒 refresh 间隔，新文档不会马上出现在搜索结果里：
- 开发/测试阶段可强制刷新：
client.IndexDocument(doc).Refresh(Refresh.WaitFor);或批量写入后调client.Indices.Refresh("my-index"); - 别循环调
Index()写大量数据：吞吐暴跌，改用Bulk()，一次提交百条以上 - 如果用了
Elastic.Clients.Elasticsearch，注意它默认不自动刷新，BulkRequest需显式设Refresh = Refresh.WaitFor - 索引别建在系统临时目录（如
%TEMP%），ES 进程重启后可能锁文件残留，导致LockObtainFailedException类错误（这其实是 Lucene 层的坑，但 ES 也会透出）
真正容易被忽略的点是：字段 mapping 和分词器必须在索引创建那一刻就定死，后续几乎无法修改；而客户端版本与服务端主版本错一位，整个查询链路就会静默失效——它不报编译错，只在运行时返回空结果或 400 错误。
