Elasticsearch集成失败主因是客户端配置、查询类型误用及JSON解析不匹配；需显式设URL、禁用sniff、配置超时与认证，全文搜用MatchQuery、精确查用TermQuery，解析时须解引用hit.Source并严格匹配字段名。
连不上 Elasticsearch，后面所有搜索逻辑都白搭；用错查询类型（比如该用 TermQuery 却写了 MatchQuery），结果为空但不报错；解析 hit.Source 时结构体字段名和 JSON key 对不上，TotalHits.Value() 返回 0——这些问题不是代码写错了，是集成链路上几个关键节点没对齐。
elastic.NewClient 连接失败的常见配置漏项
本地跑通但上 K8s 就超时、context deadline exceeded、401 Unauthorized，90% 都出在初始化 client 这一步。
- 必须显式传
elastic.SetURL("http://localhost:9200")，别依赖默认值；K8s 环境注意 Service 名（如elasticsearch.default.svc.cluster.local:9200） - 加
elastic.SetSniff(false)：Docker/K8s 内 sniff 会尝试连内网 IP，直接失败 - 设健康检查：
elastic.SetHealthcheck(true)+elastic.SetHealthcheckInterval(10 * time.Second)，否则节点挂了 client 还在重试 - 超时必须设：
elastic.SetTimeout(5 * time.Second)，默认是 0（无限等待） - 启用了 Basic Auth 就得配
elastic.SetBasicAuth("user", "pass")，漏掉就是 401，错误信息就一行401 Unauthorized
全文搜索 + 过滤组合查询怎么写才不空
MatchQuery 和 TermQuery 混用错地方，DSL 语法合法，但查不到数据——ES 不报错，只静默返回空 hits。
Golang Uber Dig
下载
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等
- 全文检索（带分词）用
MatchQuery("title", "golang tutorial")，它走 analyzer，适合text类型字段 - 精确匹配（status、category、ID）必须用
TermQuery("status", "published")，MatchQuery对keyword字段无效 - 组合条件优先用
BoolQuery().Must().Filter()：Must放全文搜（参与算分），Filter放状态/范围（不打分、缓存友好、性能更好） - 时间范围别拼字符串：
RangeQuery("created_at").Gte("now-7d").Lte("now")，ES 原生支持now-7d/d这类表达式 - 字段名必须和 mapping 完全一致：
user_id≠userId，查不到不会提示，只会返回空切片
SearchResult.Hits 解析失败的真实原因
result, err := svc.Do(ctx) 没报错，但 result.Hits.TotalHits.Value() 是 0，或 result.Hits.Hits 是空 slice——问题不在查询，而在解析。
- ES 返回的文档内容在
hit._source字段下，不是顶层 JSON；别直接json.Unmarshal(raw, &MyDoc{}) - 正确做法是调
hit.Source方法：err := json.Unmarshal(*hit.Source, &doc)，注意*hit.Source是指针 - 结构体字段标签必须严格匹配
_source中的 key：json:"title"对应{"title": "..."}，大小写、下划线都不能错 - 如果 mapping 里字段是
"published_at"，结构体就得写PublishedAt string `json:"published_at"`，别用PublishedAt自动转驼峰 -
TotalHits是个 struct，要取值必须调.Value()：result.Hits.TotalHits.Value()，直接打印是地址
最常被忽略的是字段名大小写和下划线一致性，以及 hit.Source 必须解引用才能 Unmarshal。这两个点不卡住，其他逻辑基本不会莫名其妙返回空。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
