必须用 elasticsearch.newclient（es ≥ 8.0）或 elastic.newclient（es ≤ 7.17），选错会导致 400 或 401 错误；生产环境必设 setsniff(false)，https/认证配置缺一不可，且需正确处理 result.source 和 context 超时。
用 elastic.NewClient 还是 elasticsearch.NewClient？选错直接连不上
Go 生态里主流有两个 ES 客户端库：olivere/elastic/v7（旧但成熟）和官方的 elastic/go-elasticsearch（新、更轻、v8+ 唯一支持）。关键区别不是“好不好”，而是“能不能用”——olivere/elastic 在 Elasticsearch 8.x 默认禁用 _type 后已基本不可用，而官方客户端从 v8 起强制要求 HTTPS + 认证，且不兼容 v7 的部分 API 签名。
实操建议：
- ES 版本 ≤ 7.17 → 优先用
olivere/elastic/v7，兼容性好，文档全，Get()、Search()等方法直觉性强 - ES 版本 ≥ 8.0 → 必须用
github.com/elastic/go-elasticsearch，否则会遇到400 Bad Request: unknown field [_type]或401 Unauthorized（即使没配认证） - 别混用：同一项目里同时 import 两个库，容易因
context.Context传递或错误类型冲突引发静默失败
SetSniff(false) 不是可选项，是必填项
默认开启的 sniff 功能会让客户端主动请求 /_nodes/http 获取集群真实节点列表。这在 Docker 或 Kubernetes 环境下极易失败——因为容器内看到的 node host 是内部网络地址（如 es-node-1），外部 Go 应用根本连不通，最终表现为 no available connection 或反复重试超时。
实操建议：
- 所有生产环境连接都必须显式加
elastic.SetSniff(false)（olivere）或elasticsearch.Config{Transport: ...}中禁用 sniff（官方库） - 如果 ES 是单节点（比如本地开发），只写一个
http://localhost:9200就够了；集群部署则手动列全可用 HTTP 地址，例如[]string{"http://es1:9200", "http://es2:9200"} - 别信“自动发现很智能”——它只在你完全控制网络拓扑时才可靠
Basic Auth 和 TLS 配置，漏一个就 401 或 x509: certificate signed by unknown authority
阿里云、腾讯云 ES 实例，以及自建启用了 Security 插件的集群，全部强制认证。但错误往往不报“没权限”，而是报连接失败或空响应——因为底层 HTTP client 没传 header 或跳过了证书校验。
在 Go 中使用 google/wire 实现编译时依赖注入——wire.NewSet、wire.Build、wire.Bind（接口→实现）、wire.Struct、wire.Value、wire.Interface
实操建议：
- 用
olivere/elastic：必须加elastic.SetBasicAuth(user, pass)；若用 HTTPS，还要加elastic.SetScheme("https")和elastic.SetHttpClient(&http.Client{Transport: ...})自定义 transport 跳过证书验证（仅测试） - 用官方
go-elasticsearch：认证信息要塞进Config的Username/Password字段，且必须配合Transport设置 TLS（哪怕只是&http.Transport{TLSClientConfig: &tls.Config{InsecureSkipVerify: true}}） - 配置项名大小写敏感：
Username不是username，SetBasicAuth第二个参数是密码，顺序反了会认证成功但查不到数据（因用户无权限）
client.Get().Index(...).Id(...).Do(ctx) 返回 *elastic.GetResult，但 result.Source 是 json.RawMessage
很多新手以为拿到 GetResult 就能直接取字段，结果 panic：“cannot unmarshal object into Go struct of type string”。根本原因是 ES 返回的 _source 是原始 JSON 字节流，不是解析好的 map 或 struct。
实操建议：
- 别直接访问
result.Source["field"]——它不是 map - 要么用
json.Unmarshal(result.Source, &yourStruct)反序列化到结构体 - 要么用
result.SourceAsString()（olivere）转成字符串再解析，适合调试 - 注意
result.Found必须为true才能安全读Source，否则Source是 nil，Unmarshal会 panic
最常被忽略的其实是上下文（ctx）——不带超时的 client.Search().Do(context.Background()) 一旦 ES 响应慢或挂掉，整个 goroutine 就卡死。务必用 context.WithTimeout 包一层，5 秒足够大多数查询。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
