Gin 搭 Elasticsearch 的核心问题在于搜不到、搜不准、搜得慢，主因是客户端版本错配（如 olivere/elastic/v7 不兼容 ES 8.0+）、索引配置未对齐（分词器、refresh、字段类型）、查询 DSL 写法错误（Index/Body/Context 缺一不可）。
用 Gin 搭 Elasticsearch 做搜索，核心不是“能不能连上”，而是“连上了但搜不到、搜不准、搜得慢”——这些问题 90% 出在客户端版本错配、索引配置没对齐、查询 DSL 写法不匹配这三处。
为什么 olivere/elastic/v7 在 ES 8.0+ 上会静默失败
ES 8.0+ 移除了 _type、强制 HTTPS、把 /index/_search 改成 /index/_search（路径没变但语义变了）、要求 Content-Type: application/json；而 olivere/elastic/v7 完全没适配这些。结果不是报错，是请求发出去后 ES 直接返回 406 Not Acceptable 或空响应，client.Search() 却只吐个泛化 error，日志里看不到真实原因。
- ES 7.10–7.17 → 可用
olivere/elastic/v7（仅限存量迁移） - ES 8.0+（包括刚装的 8.15 / 9.0）→ 必须用
elastic/go-elasticsearch/v9 - 混用两个客户端 →
context.Context传参冲突、http.RoundTripper复用异常，可能造成 goroutine 悬停
esapi.SearchRequest 必须显式设的三个字段
官方客户端不补默认值，漏一个就等于发了个废请求：返回空 hits、no search context found 或直接 panic。
-
Index：不能为""或"*"；生产环境禁止通配符，ES 可能拒收或打满慢日志；必须明确传[]string{"blogs"} -
Body：必须是*bytes.Reader；常见错误是json.Marshal()后忘了包一层bytes.NewReader()，导致请求体为空，ES 返回400 Bad Request -
Context：必须带超时，例如context.WithTimeout(ctx, 3*time.Second)；不设的话 HTTP client 可能卡死在连接池，goroutine 悬停
中文搜不到？先盯住分词器、refresh 和字段类型
90% 的“搜不到”不是 query 写错，而是索引侧配置和写入行为不一致。
- 中文分词：索引用了
ik_max_word，但查询 DSL 没加"analyzer": "ik_max_word"，ES 默认走standard分词器——“人工智能”被切成 “人工”“智能”，而 IK 会切出完整词项，自然匹配不上 -
refresh延迟：文档写入后默认 1 秒才可搜索；刚Index()完立刻Search()，大概率为空；开发期可临时加Refresh: "true"，但批量导入时严禁使用 - 字段类型错配：
title字段 mapping 是keyword，却用MatchQuery查——keyword不分词，MatchQuery查不了；该用TermQuery
解析 hit.Source 时最容易 panic
ES 返回的文档内容在 hit._source 下，不是 JSON 根对象。直接 json.Unmarshal(raw, &MyDoc{}) 会失败或字段为空。
- 正确做法是调
hit.Source方法：err := json.Unmarshal(hit.Source, &MyDoc{}) - 注意：如果用了
elastic/go-elasticsearch/v9，hit.Source是json.RawMessage类型，需手动解码；olivere/elastic/v7则提供hit.SourceObject()辅助方法 - 字段名必须和 mapping 定义完全一致（大小写、下划线），否则反序列化后为空
最常被忽略的是：ES 8.x 要求所有通信走 HTTPS，本地开发用 HTTP 时必须显式关闭证书校验（仅限测试），否则 client.Info() 都过不去；还有就是 bulk 写入时没处理 429 Too Many Requests，BulkIndexer 默认不重试这类状态码，看着成功实则丢数据。
