必须用 elastic/go-elasticsearch/v9 客户端：因 ES 8.0+ 移除 _type、强制 HTTPS、改写路径、要求 JSON Content-Type，olivere/elastic/v7 不兼容（返回 406 或空结果），v8 已归档；esapi.SearchRequest 必须显式设 Index（非空切片）、Body（bytes.NewReader）、Context（带超时）；响应体需 defer res.Body.Close()，结果须用 ioutil.ReadAll 后手动映射至干净结构体，避免 panic。
直接用 elastic/go-elasticsearch/v9 客户端集成 Fiber，别套中间层——Fiber 本身不干预 HTTP client，但你若用错客户端版本、漏设关键字段或忽略响应体关闭，Search 就会静默返回空结果或卡死 goroutine。
为什么不能用 olivere/elastic/v7 或 v8？
ES 8.0+（包括当前主流的 8.15 / 9.0）已移除 _type、强制 HTTPS、改写 /_search 路径、要求 Content-Type: application/json。olivere/elastic/v7 完全不兼容这些变更，现象是：req.Do() 不报错，但返回 406 Not Acceptable 或空 Hits；v8 已归档且无维护。必须用官方 elastic/go-elasticsearch/v9。
- 验证方式：运行
go get github.com/elastic/go-elasticsearch/v9，导入时检查是否为github.com/elastic/go-elasticsearch/v9/esapi - 混用两个客户端会导致
context.Context传参冲突和http.RoundTripper复用异常，goroutine 悬停无日志 - Fiber 的
ctx.SendString()不影响 ES 客户端行为，问题只出在初始化和请求构造环节
esapi.SearchRequest 必须显式填哪三个字段？
esapi.SearchRequest 是“半裸”结构体，不补默认值。漏一个，ES 就当废请求处理，现象是空结果、no search context found 或 panic。
-
Index：必须是[]string{"articles"}这种非空切片，不能为""或"*"（生产环境会被拒绝或触发慢日志） -
Body：必须是*bytes.Reader，常见错误是json.Marshal()后忘了包bytes.NewReader()，导致请求体为空，ES 返回400 Bad Request -
Context：必须带超时，例如context.WithTimeout(ctx, 3*time.Second)；不设则 HTTP client 卡在连接池，整个 Fiber handler 悬停
示例：
Golang Uber Dig
下载
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等
立即学习“go语言免费学习笔记（深入）”；
req := esapi.SearchRequest{
Index: []string{"blogs"},
Body: bytes.NewReader([]byte(`{"query":{"match":{"title":"golang"}}}`)),
Context: context.WithTimeout(c.Context(), 3*time.Second),
}
res, err := req.Do(c.Context(), es)
if err != nil {
c.Status(500).SendString(err.Error())
return
}
defer res.Body.Close() // 必须！否则 fd 泄露
怎么把搜索结果安全塞进 Fiber Response？
Fiber 的 c.JSON() 不能直接塞 esapi.SearchResponse，它含未导出字段和 io.ReadCloser，会 panic。必须手动提取并映射到干净结构体。
- 别直接
json.Unmarshal(res.Body, &v)：res.Body 是已读过的流，需用ioutil.ReadAll(res.Body)先取原始字节 - 正确做法：定义
type SearchResult struct { Hits struct { Total int `json:"total"` Hits []struct { Source map[string]interface{} `json:"_source"` Highlight map[string][]string `json:"highlight"` } `json:"hits"` } `json:"hits"` }，再json.Unmarshal(raw, &sr) - 高亮内容在
Highlight字段下，不是合并进_source；前端需自己拼接渲染，Go 层不自动 merge - 分页注意：
from/size超过 10000 会触发Result window is too large，必须改用search_after + sort，且sort字段不能为_score（不稳定）
中文搜不到？先盯住三件事
90% 的“搜不到”和 Fiber 无关，是索引侧配置和查询 DSL 没对齐。
- 写入和查询必须用同一分词器：mapping 中字段声明
"analyzer": "ik_max_word"，查询 DSL 的match里也得显式加"analyzer": "ik_max_word"；ES 不自动继承 - 字段类型错配：
title是keyword类型，却用MatchQuery查——该用TermQuery；text类型才走分词 - refresh 延迟：文档写入后默认 1 秒才可搜到；Fiber handler 里刚
Index()完立刻Search()，大概率为空；开发期可临时加Refresh: "true"，但批量导入禁用
最易忽略的是 mapping 和 query 的 analyzer 同步——写入和查询用不同分词器，等于两边说不同语言，全文检索就失效了。
