ES Go客户端查询静默失败主因是字段类型错配：text字段误用TermQuery、keyword字段误用MatchQuery、date字段RangeQuery传字符串；须严格匹配类型并用BoolQuery.Must().Filter()组合，search_after需排序字段启用doc_values且值类型顺序一致，结构体须嵌套_source解析，推荐esbuilder构建DSL。
用 olivere/elastic 构建 BoolQuery + Range + Term 组合查询时字段类型不匹配就静默失败
查不到数据但没报错，是 ES Go 客户端最典型的“假成功”场景。根本原因不是语法错，而是 MatchQuery 误用于 keyword 字段、TermQuery 误用于 text 字段，或 RangeQuery 传了字符串而非时间戳类型值。
实操建议：
立即学习“go语言免费学习笔记（深入）”；
Golang Uber Dig
下载
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等
- 全文搜 title、content 等 text 字段 → 用
MatchQuery("title", "golang")，它走 analyzer 分词 - 精确匹配 status、category、user_id 等 keyword 字段 → 必须用
TermQuery("status", "published")，别用MatchQuery - 时间范围查
created_at→ 用RangeQuery("created_at").Gte("2024-01-01T00:00:00Z").Lte("now")，ES 能识别now-7d，但字段 mapping 必须是date类型 - 组合条件统一走
BoolQuery().Must().Filter()：全文搜放Must，状态/范围/exists 放Filter（不参与算分、缓存友好）
search_after 替代 from+size 实现深度分页时必须设 from=0 且排序字段不可为空
search_after 是查超过 10000 条数据的唯一可靠方式，但它比 scroll 更轻量、无上下文生命周期限制。问题在于：一旦漏掉关键约束，请求直接 400 错误，错误信息只显示 "from must be less than or equal to 10000"，非常误导。
实操建议：
立即学习“go语言免费学习笔记（深入）”；
-
From参数必须显式设为0或-1，不能省略（olivere/elastic 默认是 0，但显式写更安全） - 排序字段必须在 mapping 中启用了
"doc_values": true（默认开启，但自定义 mapping 时可能关掉） -
search_after值必须和 sort 数组顺序、类型严格一致：比如 sort 是[{"id": "asc"}, {"ts": "desc"}]，那search_after就得是[]any{123, "2024-01-01T00:00:00Z"} - 首次请求不带
search_after，取回结果后，从result.Hits.Hits[len(result.Hits.Hits)-1].Sort拿最后一项的 sort 值
解析 SearchResult.Hits.Hits 为空却查不到原因？结构体嵌套和字段 tag 是关键
result, err := client.Search(...).Do(ctx) 成功返回，但 result.Hits.TotalHits.Value 是 0 或 result.Hits.Hits 是空切片——90% 是结构体字段没对上 ES 返回的 JSON 层级或 key 名。
实操建议：
立即学习“go语言免费学习笔记（深入）”；
- ES 返回的文档原始数据在每个 hit 的
_source字段下，不是平铺在 hit 顶层；所以要么用hit.Source手动 json.Unmarshal，要么定义结构体时加嵌套：type Hit struct { Source *YourDoc `json:"_source"` } - 字段名必须和 mapping 定义完全一致：
user_id≠userId，publishname≠publishName，大小写、下划线都算不同字段 - 避免用
json:"name"直接映射顶层字段，ES 返回的 hit 结构是：{"_index":"x","_id":"1","_source":{"name":"foo"}}，没做嵌套就永远解不出name - 调试时先打印
result.Hits.Hits[0].Source的 raw bytes，确认数据真实存在再调结构体
用官方 go-elasticsearch/v8 时 DSL 必须手拼 map[string]interface{}，但可借 esbuilder 封装
官方包性能好、维护活跃，但写复杂查询像写 JSON：嵌套深、易拼错 key、无编译检查。比如一个带 filter、aggs、highlight 的查询，5 层 map 嵌套极易出错。
实操建议：
立即学习“go语言免费学习笔记（深入）”；
- 不要硬刚原生 map —— 直接用
github.com/liupengh3c/esbuilder这类轻量 DSL 构建库，它把BoolQuery、TermsAggregation等封装成链式方法，输出仍是标准map[string]interface{}，可无缝喂给官方 client - esbuilder 支持
search_after、track_total_hits、collapse等高频字段，比 olivere/elastic/v7 更新及时（后者已两年未维护） - 若需极致控制，可在 esbuilder 生成的 DSL 上做微调，比如手动加
"version": true或改timeout字段，不影响主体结构
