Go查Elasticsearch核心是选对客户端并写对查询结构：go-elasticsearch/v8需显式WithBody()传序列化query，olivere/elastic/v7封装查询但版本强绑定；查不到结果时优先验证索引名、字段类型与分词器配置。
Go 语言里查 Elasticsearch，核心就两件事：用对客户端、写对查询结构。官方 go-elasticsearch/v8 和社区老牌 olivere/elastic/v7 都能用，但选错版本或漏掉关键参数，Search() 调用会直接返回空结果或 panic，不是代码写错了，而是请求根本没发出去或被 ES 拒绝。
用 go-elasticsearch/v8 查全文搜索必须传 WithBody()
官方客户端不自动序列化 query map，必须显式转成 io.Reader 并用 WithBody() 注入。漏掉这步，请求 body 是空的，ES 返回 200 但 hits 为 0，看着没报错，实际没搜到任何东西。
-
toJSONReader(query)要自己实现，不能直接传map[string]interface{} - 常见错误写法：
s.client.Search(s.client.Search.WithIndex("logs"))—— 没带 query，等价于查全部文档但不返回 source - 正确示例（match 查询）：
query := map[string]interface{}{ "query": map[string]interface{}{ "match": map[string]interface{}{"title": "golang"}, }, } res, err := s.client.Search( s.client.Search.WithIndex("blogs"), s.client.Search.WithBody(toJSONReader(query)), )
olivere/elastic/v7 的 MatchQuery 更直觉，但要注意版本锁死
这个库封装了 query 构建逻辑，elastic.NewMatchQuery("content", "es") 直接生成合法 DSL，适合快速验证逻辑。但它和 ES 版本强绑定：v7 客户端只能连 ES 7.x，连 ES 8.x 会因 API 变更（如 _search 默认不返回 _type）而失败。
- ES 8.x 集群必须用
go-elasticsearch/v8，否则IndexNames()等元数据接口会 404 - v7 客户端里
client.Search().Index("logs").Query(q).Do(ctx)不需要手动处理 JSON，但 query 对象必须用它提供的类型（NewTermQuery、NewBoolQuery等） - 别混用：在 v7 里手写 raw JSON 字符串传给
Query()，容易因字段名大小写或嵌套层级出错
查不到结果？先确认 _index 和 analyzer 是否匹配
Go 代码发出去的请求没问题，不代表 ES 里真有可匹配的数据。常见断点位置：
立即学习“go语言免费学习笔记（深入）”；
- 索引名写错：代码里写
"blog"，实际 ES 里是"blogs"或"blog_v2"—— 用client.Indices.Get()（v8）或client.IndexNames()（v7）先确认真实 index 列表 - 字段未分词：如果
title映射是"type": "keyword"，match查询永远为空，得换term或改 mapping - 中文没配 IK 分词器：默认 standard analyzer 对中文按字切分，搜“搜索引擎”得输“搜”“索”“引”“擎”才能命中 —— 检查索引 settings 里的
analysis.analyzer
真正卡住人的从来不是语法，而是 query 发出去了、ES 也响应了、但 hits.Total.Value 是 0 —— 这时候别调 Go 代码，先用 Kibana 的 Dev Tools 贴同样的 JSON 请求，看是不是数据本身或 mapping 的问题。
