必须显式配置 elastic.NewClient：设 URL、禁用 Sniff、启用健康检查、设超时和 Basic Auth；全文搜用 MatchQuery，精确匹配用 TermQuery；组合查询用 BoolQuery.Must().Filter()；解析结果需用 hit.Source 解析，TotalHits 须调 Value() 方法获取。
怎么用 elastic.NewClient 连上 Elasticsearch
连不上 ES 是后续所有操作失败的根源，90% 的「查询没返回」「context deadline exceeded」都卡在这步。别信文档里默认不设超时、不配健康检查的写法。
实操建议：
立即学习“go语言免费学习笔记（深入）”；
- 必须显式配置
elastic.SetURL("http://localhost:9200")，别依赖默认值；本地开发用http://localhost:9200，K8s 环境注意 Service 名和端口 - 加
elastic.SetHealthcheck(true)和elastic.SetHealthcheckInterval(10 * time.Second)，否则节点挂了客户端还傻等 - 超时必须设：用
elastic.SetSniff(false)关闭自动发现（尤其在 Docker/K8s 里，sniff 会连内网 IP 导致失败），再配elastic.SetTimeout(5 * time.Second) - 如果 ES 启用了 Basic Auth，得传
elastic.SetBasicAuth("user", "pass")，漏掉就直接 401，错误信息是401 Unauthorized
怎么写 SearchService 的全文搜索 + 过滤组合查询
ES 的 match 和 term 混用错地方，结果就全空——不是语法报错，是逻辑查不到数据。Golang client 把 DSL 封装成链式调用，但底层还是 JSON，字段类型不匹配就静默失败。
实操建议：
立即学习“go语言免费学习笔记（深入）”；
- 全文搜索用
MatchQuery("title", "golang")，它会走 analyzer；精确匹配（比如 status=“published”）必须用TermQuery("status", "published")，别用MatchQuery去查 keyword 字段 - 组合多个条件用
BoolQuery().Must(...).Filter(...)：全文搜放Must，范围/状态过滤放Filter（不参与算分、性能更好） - 时间范围别手写字符串，用
RangeQuery("created_at").Gte("2024-01-01").Lte("now")，ES 能识别now-7d这类表达式 - 字段名要和 mapping 严格一致——
user_id和userId是两个字段，查不到不会报错，只会返回空 hits
怎么处理 SearchResult.Hits.Hits 解析失败
常见现象：result, err := svc.Do(ctx) 没报错，但 result.Hits.TotalHits.Value 是 0，或 result.Hits.Hits 为空切片，实际数据明明存在。根本原因：结构体字段标签没对齐 ES 返回的 JSON key。
实操建议：
立即学习“go语言免费学习笔记（深入）”；
- 别用
json:"name"直接映射，ES 返回的 hit 里 doc 在_source字段下，所以你的结构体得嵌套一层或用elastic.SearchResult自带的Source方法 - 安全做法是先用
hit.Source拿原始[]byte，再json.Unmarshal到 struct；别依赖hit.Id或hit.Type（7.x+ 已废弃，返回空） - 如果字段可能缺失（比如有的文档没
tags数组），struct 字段声明为指针类型：Tags *[]string `json:"tags"`，避免 unmarshal panic - 查总数别只看
result.Hits.TotalHits.Value，ES 7.0+ 的TotalHits是interface{}类型，得用result.Hits.TotalHits.Value() int64方法取值
为什么 Scroll 查询总在第二页断掉
Scroll 不是分页，是快照式遍历。很多人当成 from/size 用，结果第二次 Scroll 请求返回 "scroll_id not found" 或空结果——因为 scroll context 超时被 ES 清理了，或者没传对上一次返回的 scroll_id。
实操建议：
立即学习“go语言免费学习笔记（深入）”；
- 初始化 scroll 必须设
SearchService.Scroll("2m")，单位是时间（不是请求数），2m 表示这个快照最多活 2 分钟 - 每次后续 scroll 请求，必须用上一次响应里的
result.ScrollId，且不能重新调SearchService.Scroll(...)，而是用elastic.NewScrollService(client).ScrollId(result.ScrollId) - scroll 结束后主动清理：调
elastic.NewClearScrollService(client).ScrollId(scrollID).Do(ctx)，不然 ES 内存不释放 - scroll 不适合实时性要求高的场景，它基于第一次查询的索引状态，期间新写入的文档不会被扫到
ES 的 mapping 类型、analyer 配置、字段是否 indexed、是否 stored，这些都在后台悄悄决定你能不能查到——代码写对了，数据却不见，八成是 schema 和查询方式没对齐。多打 result.DebugInfo() 看真实请求/响应，比猜强。
