ES 8.0+ 必须使用 elastic/go-elasticsearch/v9，因协议断层（移除 _type、强制 HTTPS、路径与 header 变更）导致 olivere/elastic/v7 连接即失败，返回 406 或空结果；v9 要求 esapi.SearchRequest 显式设置 Index、Body、Context 三字段，缺一则请求无效。
ES 8.0+ 必须用 elastic/go-elasticsearch/v9，olivere/elastic/v7 连都连不上——不是你代码写错了，是协议断层导致静默失败。
选错客户端：连请求都发不出去
ES 8.0+ 移除了 _type、强制 HTTPS、调整了 /_search 路径、要求 Content-Type: application/json，而 olivere/elastic/v7 完全没适配这些变更。现象是：req.Do() 返回空 hits 或直接 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。
elasticsearch-9.4.1-linux
下载
Elasticsearch 9.4.1 Linux 版本现已开放下载，这是官方最新发布的分布式搜索与分析引擎。Linux 版本全面支持 x86_64 与 aarch64 架构，提供 .tar.gz、.deb 及 .rpm 多种安装包格式，可灵活适配 Ubuntu、CentOS、Debian 等主流发行版。该版本延续了 9.4 系列的核心特性，包括原生 Prometheus 支持、正式版 Elast
-
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, &doc) - 注意：如果
hit.Source为 nil（比如设置了Source: false），直接解码会 panic - 建议加判空：
if hit.Source != nil { json.Unmarshal(hit.Source, &doc) }
真正麻烦的从来不是怎么写 query，而是 mapping 设对没、分词器配准没、refresh 控制得当没、client 版本和 ES 版本咬合没——这些点一错，查半天也看不出哪错了。
