ES 8.0+ 必须使用 elastic/go-elasticsearch/v9，olivere/elastic/v7 因协议不兼容无法连接；需显式配置 HTTPS 地址、Basic Auth、BoolQuery 组合查询，并严格匹配字段类型与 mapping。
ES 8.0+ 必须用 elastic/go-elasticsearch/v9，olivere/elastic/v7 已归档且协议不兼容，连都连不上——不是查询写错，是请求根本没进 ES 处理流程。
连不上 ES？先看客户端版本和基础配置
本地跑通但上线就 400 Bad Request 或 406 Not Acceptable，90% 是客户端版本错。ES 8.x 禁用 _type、强制 HTTPS、改了 /_search 路径格式和 Authorization header，olivere/elastic/v7 还按 7.x 协议拼包，直接被拒。
- 新项目一律用
go get github.com/elastic/go-elasticsearch/v9 -
elastic.NewClient不再存在，改用elasticsearch.NewClient+ 显式Config - 必须设
Addresses: []string{"https://es.example.com:9200"}，HTTP 默认被拒；若用 HTTP，得在 ES 配置里显式开http.security.enabled: false（仅限测试） - Basic Auth 要传
Username和Password字段到Config，漏掉就是401 Unauthorized
多维过滤怎么组合？BoolQuery 是唯一可靠路径
想同时查“语言=Go”“难度=中级”“更新时间近7天”，不能靠多个 MatchQuery 叠加——字段类型不匹配时静默返回空结果，也不报错。
- 全文字段（如
title）用MatchQuery("title", "Go教程") - 精确值字段（如
language、level）必须用TermQuery("language", "go")，别用MatchQuery去查keyword类型 - 时间范围用
RangeQuery("updated_at").Gte("now-7d/d")，/d表示按天截断，避免时区误差 - 组合全部塞进
BoolQuery().Must().Filter()：全文搜放Must，状态/枚举/时间放Filter（不参与打分、性能更好）
查不到数据？别急着改 query，先盯索引侧三件事
返回 Hits.TotalHits.Value() == 0 但你知道数据存在，大概率是索引配置或写入行为不一致。
立即学习“go语言免费学习笔记（深入）”；
- 确认字段 mapping：比如
language设成了text却用TermQuery查，会因分词后无法精确匹配而漏掉；应设为keyword或用MatchQuery+analyzer - 写入后没 refresh：开发环境可加
Refresh: "true"强制立即可见；生产环境靠refresh_interval控制，默认 1s，别依赖“写完立刻能搜” - 字段名大小写/下划线严格匹配：
language_tag和languageTag是两个字段，查错不会报错，只会空结果
esapi.SearchRequest 必须填全三个字段
官方客户端不补默认值，漏一个就 panic 或返回空 hits。尤其容易漏的是 Body 类型和 Context 超时。
-
Index：传[]string{"courses"}，别传""或"*"，ES 8+ 生产环境会拒收通配符 -
Body：必须是*bytes.Reader，json.Marshal()后得套bytes.NewReader()；传map[string]interface{}编译不过，传 raw string 容易引号嵌套出错 -
Context：必须带超时，例如context.WithTimeout(ctx, 3*time.Second)；不设的话 HTTP client 可能卡死在连接池，goroutine 悬停无提示
最常被忽略的其实是字段类型和 mapping 的一致性——query 写得再对，如果索引时字段被自动 mapping 成了 text，而你又用 TermQuery 去查，结果永远为空。调试时先用 Kibana 的 GET /courses/_mapping 看一眼实际类型，比反复改 query 有效得多。
