必须用elastic/go-elasticsearch/v9，因ES 8.0+强制HTTPS、移除_type、调整/_search路径、要求Content-Type: application/json，olivere/elastic/v7未适配致400/406错误；esapi.SearchRequest须显式设Index、Body(*bytes.Reader)、Context(带超时)。
用 elastic/go-elasticsearch/v9，别碰 olivere/elastic/v7 —— ES 8.0+ 协议已变，后者连请求都发不出去，不是代码错，是协议断层。
选对客户端：v9 是唯一能跑通 ES 8.x/9.x 的选择
ES 8.0 起强制 HTTPS、移除 _type、/_search 路径结构变更、要求 Content-Type: application/json，而 olivere/elastic/v7 完全没适配这些。现象是：req.Do() 返回空结果或直接 406 Not Acceptable，错误日志里还看不到真实原因。
- ES 7.10–7.17 → 可用
olivere/elastic/v7（仅限存量迁移） - ES 8.0+（含 8.15 / 9.0）→ 必须用
elastic/go-elasticsearch/v9 - 同一项目混用两个客户端 →
context.Context传参冲突、http.RoundTripper复用异常，可能静默超时
构造 esapi.SearchRequest 必须显式设三个字段
官方客户端不补默认值，漏一个就等于发了个废请求：返回空结果、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 写错，而是索引侧配置和写入行为不一致。
立即学习“go语言免费学习笔记（深入）”；
- 中文分词：索引用了
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, &doc)，注意*hit.Source是指针 - 别忽略
hit.Source == nil的情况，尤其当文档被部分排除（如_source: false）时 - 如果字段名含下划线或大小写混用，Go 结构体 tag 必须严格对齐：
json:"user_name"对应 ES 中user_name字段
最常被忽略的是：ES 返回的 error 不是 HTTP status code，而是响应体里的 error 字段或 status 非 200；只判断 err != nil 会漏掉大量 400/404 类错误。
