用 olivere/elastic 连不上 Elasticsearch 时，先检查客户端版本与 ES 版本是否兼容：v7.x 客户端仅支持 ES 7.x，连接 8.x 需改用官方 go-elasticsearch SDK，并注意 HTTP 头、TLS 和超时配置。
用 olivere/elastic 连不上 Elasticsearch？先检查客户端配置和版本兼容性
最新版 olivere/elastic（v7.x）默认只支持 Elasticsearch 7.x，如果你连的是 8.x 集群，会卡在连接阶段或报 406 Not Acceptable —— 这不是网络问题，是 HTTP 头不匹配。v8+ 集群强制要求 Accept: application/json 和 Content-Type: application/json，而旧版 client 默认发的是 application/vnd.elasticsearch+json; compatible-with=7。
- ES 7.x → 用
olivere/elasticv7.0.29（最后一个 v7 分支） - ES 8.x → 改用官方 SDK
github.com/elastic/go-elasticsearch，olivere/elastic不维护 v8 兼容 - 连本地
http://localhost:9200时，确保没开 TLS；开了就得配elastic.SetScheme("https")和证书 - 超时要显式设：
elastic.SetHealthcheckTimeout(5 * time.Second)，否则默认 1s 健康检查容易误判断连
Search().Index().Query() 返回空结果？别急着怀疑数据，先看查询 DSL 和字段映射
常见现象是：Kibana 能搜出文档，Go 里 Search() 却返回 0 hits。大概率是字段类型不匹配导致查询未命中 —— 比如你对一个 text 字段用了 term 查询（精确匹配），但该字段实际被分词了，原始值 "user login" 存成 ["user", "login"]，term 查 "user login" 就找不到。
- 查字符串建议优先用
match或multi_match，不是term - 想精确匹配，字段得是
keyword类型，查时用term；或者用match_phrase - 调试时加
.Pretty(true)，打印出完整请求体，粘到 Kibana Console 里跑一遍，确认 DSL 本身没问题 - 注意
.Index("my-index-2024")的索引名必须存在，不支持通配符自动展开（比如my-index-*）
怎么安全传参避免注入？别拼接 JSON 字符串，用 elastic.NewBoolQuery() 等构造器
有人把用户输入直接塞进 raw JSON string 再喂给 Search().Source()，这等于把 ES 查询当 SQL 用 —— 字段名、值、嵌套结构全由外部控制，可能触发意外聚合、慢查询甚至权限越界（如果集群没开 RLS）。
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等
- 所有查询条件走 builder 模式：
elastic.NewMatchQuery("title", userInput)，它会自动转义特殊字符 - 字段名用常量或白名单校验，禁止用户传
"_script"、"runtime_mappings"这类高危 key - 分页用
.From()+.Size()，别信前端传来的size=10000，服务端要硬限制（比如if size > 100 { size = 100 }） - 需要高亮就加
.Highlight(...)，别自己解析_source字段再正则替换，性能差还容易错位
为什么 SearchResult.Hits.Hits 是空 slice，但 TotalHits() 却大于 0？
这是 ES 的“浅层分页”机制导致的：默认只返回命中的文档内容，但 TotalHits() 是准确总数（除非启用了 track_total_hits=false）。但更常见的原因是 SearchResult 解析失败 —— 比如你用了 .FetchSourceContext(elastic.NewFetchSourceContext(false)) 关掉 _source，那 Hits 里每个 Hit 的 Source 就是 nil，反序列化时跳过整个 Hit，看起来像没结果。
立即学习“go语言免费学习笔记（深入）”；
- 确认是否调了
.FetchSource(true)（默认就是 true，除非你手动关了） - 检查 struct tag 是否匹配：ES 返回字段是
"user_name"，你的 Go struct 却写UserName string `json:"userName"`，就会解不出 - 用
result.Each(reflect.TypeOf(&YourStruct{}))替代手动遍历Hits，能自动跳过解析失败项并报错 - 如果只要计数，直接用
Count().Do(ctx)，比Search().Size(0)更轻量
ES 查询不是黑盒，client 的每个方法调用都对应明确的 HTTP 动作和参数组合。最容易忽略的是版本错配和字段类型误解——这两点不解决，后面所有查询逻辑都建立在沙上。
