必须用elastic/go-elasticsearch/v9客户端，显式配置addresses、自定义transport跳过证书校验（https场景），searchrequest需完整设置index、body（*bytes.reader）、context（带超时），并严格对齐分词器、字段类型与refresh机制。
用 Echo 框架集成 Elasticsearch 做全文检索，核心不是“怎么写 handler”，而是“客户端连得上、请求发得对、结果解析得稳”。ES 8.0+ 或 9.x 环境下，olivere/elastic/v7 已归档且协议不兼容，直接连不上——这不是 Echo 配置问题，是底层 HTTP 请求被 ES 拒绝。
必须用 elastic/go-elasticsearch/v9 初始化客户端
ES 8.15 / 9.0 默认强制 HTTPS、移除 _type、要求 Content-Type: application/json，而 olivere/elastic/v7 完全没适配。现象是：client.Search() 返回空 Hits 或 406 Not Acceptable，错误日志里没有有效线索。
- 安装命令必须明确版本：
go get github.com/elastic/go-elasticsearch/v9@latest -
elasticsearch.NewClient()必须传elasticsearch.Config{Addresses: []string{"https://es.example.com:9200"}}，漏掉Addresses会 panic - 开发环境若用自签名证书，需自定义
Transport：Transport: &http.Transport{TLSClientConfig: &tls.Config{InsecureSkipVerify: true}} - 别开
Sniff: true（默认关），K8s 或 Istio 下自动发现节点大概率失败并阻塞初始化
esapi.SearchRequest 的三个字段一个都不能少
官方 v9 客户端不补默认值，漏填任一字段，请求就等于废的：返回空结果、no search context found，甚至 panic，但 err 可能为 nil。
-
Index：必须是非空[]string{"articles"}，不能是""或"*"；生产环境通配符会被 ES 拒收或打满慢日志 -
Body：必须是*bytes.Reader，常见错误是json.Marshal(q)后直接赋值，正确写法是bytes.NewReader(jsonBytes) -
Context：必须带超时，例如context.WithTimeout(ctx, 3*time.Second)；不设会导致 goroutine 卡在连接池，悬停不释放
中文搜索失效？先查分词器和字段类型是否对齐
90% 的“搜不到”不是 query 写错，而是索引侧和查询侧不一致。Kibana 能搜出结果，Go 里为空，基本就是这三处断了。
- 写入时用了
ik_max_word，但查询 DSL 没显式加"analyzer": "ik_max_word"，ES 默认走standard分词器，“人工智能”被切成 “人工”“智能”，匹配不上 -
title字段 mapping 是text类型才适用MatchQuery；若是keyword，必须用TermQuery，否则永远查不到 - 刚
Index()完立刻Search()，大概率为空——ES 默认refresh_interval是 1 秒；开发期可临时加Refresh: "true"，但批量导入时严禁使用
解析 hit.Source 时最容易 panic
ES 返回的文档内容在 hit._source 下，不是顶层 JSON 对象。直接 json.Unmarshal(raw, &MyDoc{}) 会失败或字段全为零值。
- 必须调用
hit.Source方法：err := json.Unmarshal(*hit.Source, &doc)，注意*hit.Source是指针解引用 - 结构体字段名必须和 mapping 定义的字段名完全一致：
user_id≠userId，created_at≠createdAt，差一个下划线就解析失败 - 时间字段推荐用
time.Time类型，ES 8.x+ 要求@timestamp是date类型，否则 bulk 写入可能静默失败
最易被忽略的是：v9 客户端不自动关闭响应体，每次 req.Do() 后必须 defer res.Body.Close()；漏掉就会 fd 泄露，服务跑几天后卡死。这不是 Echo 的事，是每个 HTTP client 的责任。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
