直接用elastic官方客户端连接ES超时或panic，根本原因是默认配置未设超时、未关sniffing、未复用client实例，且未处理TLS验证与context传递。
为什么直接用 elastic 官方客户端连接 ES 会超时或 panic
Go 微服务里连 Elasticsearch，最常见的是用 olivere/elastic（v7）或官方 elastic/go-elasticsearch（v8+）。但很多人一上来就写 elastic.NewClient()，结果在 Kubernetes 环境里频繁报 context deadline exceeded 或 panic: runtime error: invalid memory address。根本原因不是 ES 挂了，而是默认配置没设超时、没配健康检查、没复用 client 实例。
- 必须显式传入带超时的
context——比如context.WithTimeout(ctx, 5*time.Second)，否则底层 HTTP 请求可能卡死 -
elastic.Client是线程安全的，应全局复用一个实例，不要每次请求都 new 一个 - v8 客户端默认启用 sniffing（自动发现节点），但在 Service Mesh（如 Istio）下容易失败，建议关掉：
elastic.Config{Sniff: false} - 如果用自签名证书，得手动配置
Transport并跳过验证（仅测试环境）：&http.Transport{TLSClientConfig: &tls.Config{InsecureSkipVerify: true}}
怎么写一个安全可用的 Search 函数支持模糊匹配和分页
ES 的 Go 客户端不提供开箱即用的“全文搜索”封装，你得自己拼 body JSON。别用字符串拼接，要用 map[string]interface{} 或结构体序列化，否则字段名拼错、类型不对会返回 400 Bad Request 且错误信息极难定位。
- 核心是构造
match查询：字段要加.keyword后缀才能精确匹配，不加才是分词模糊查；比如查商品名，"name": "iphone"走分词，"name.keyword": "iPhone 15"才是精确匹配 - 分页不能只靠
from/size，超过 10000 条会报Result window is too large，必须用search_after+sort（推荐按_id或时间戳排序） - 聚合统计（比如按分类统计数量）要单独加
aggs字段，和query同级，不是嵌套在 query 里 - 示例片段：
body := map[string]interface{}{ "query": map[string]interface{}{ "match": map[string]interface{}{"title": "golang"}, }, "from": 0, "size": 20, "sort": []map[string]interface{}{{"_score": map[string]string{"order": "desc"}}}, }
微服务里怎么避免 ES 查询拖垮整个接口链路
ES 查询慢、不稳定，直接同步调用会让上游 HTTP 接口响应时间飙升甚至超时。尤其当多个服务共用同一个 ES 集群时，一个慢查询可能引发雪崩。
- 所有 ES 调用必须包裹
context.WithTimeout，且 timeout 值要比上游接口总超时小至少 200ms（留出序列化、网络抖动余量） - 高频低优先级查询（比如后台报表）建议降级：先查缓存（Redis），缓存 miss 再查 ES，并异步回填缓存
- 对非关键字段（如用户评论）做查询熔断：连续 3 次
5xx或超时，接下来 60 秒直接返回空结果，不发请求 - 别在事务中调 ES——ES 不支持 ACID，也别指望它强一致；写完 DB 后用消息队列异步更新 ES 索引更可靠
索引 mapping 设计不当会导致 Go struct 反序列化失败
ES 返回的 JSON 字段类型和 Go struct 字段类型不匹配时，json.Unmarshal 会静默失败或赋零值（比如把 "price": 99.9 解成 int 字段就变 0），排查起来特别费劲。
立即学习“go语言免费学习笔记（深入）”；
- 务必在创建索引时明确定义
mapping，尤其是日期字段用date类型而非text，否则 Go 里反序列化成string再转time.Time容易 panic - Go struct 字段 tag 要和 ES 字段名严格对应：
json:"user_name"对应 ES 中user_name，大小写、下划线都不能错 - 遇到动态字段（比如日志中的
extra.*），别硬塞进固定 struct，改用map[string]interface{}接收再按需取值 - 用
elastic.SearchResult.Hits.TotalHits.Value获取总条数，注意 v7 和 v8 返回结构不同：v8 是elastic.TotalHits{Value: 123}，v7 是int64
