go连接elasticsearch需严格匹配es版本与客户端：v7用olivere/elastic/v7，v8必须用elastic/go-elasticsearch/v8并强制配置username/password；addresses须带协议和末尾斜杠，id推荐用业务主键。
Go 连接 Elasticsearch 不是“配个地址就能用”，关键看版本、认证方式和客户端选型——v7 和 v8 的客户端不兼容，elastic/v7 和 go-elasticsearch/v8 的初始化、API 调用方式完全不同，强行混用会直接 panic 或返回 400 Bad Request。
用对客户端：v7 和 v8 不能共存
v7 客户端（olivere/elastic/v7）已归档不再维护，但大量老项目仍在用；v8 客户端（elastic/go-elasticsearch/v8）是 Elastic 官方维护的现代实现，取消了 _type，强制要求显式传 Username/Password（即使连本地单节点也要设，否则报 401 Unauthorized）。
- 如果你的 ES 是 7.x（如
7.12.1），优先用olivere/elastic/v7，避免踩 v8 的 auth 兼容坑 - 如果 ES 是 8.x（或阿里云/腾讯云新版托管实例），必须用
go-elasticsearch/v8，且配置中Username不能省——哪怕你没开安全模块，ES 8 默认启用了内置安全（elastic用户始终存在） -
go-elasticsearch/v7是过渡包，不推荐新项目使用；它不支持 ES 8 的 API 变更，比如Index()方法签名和错误返回结构都不同
连不上？先盯住这三个配置项
90% 的连接失败不是网络问题，而是配置写错位置或类型不对。尤其注意 Addresses 必须带协议、结尾斜杠；Username/Password 在 v8 中是 struct 字段，不是 URL 参数。
-
Addresses值必须是完整 URL，例如"http://192.168.1.8:9200/"（末尾/不能少），写成"192.168.1.8:9200"会静默失败 - v8 中必须显式传
Username和Password，哪怕 ES 配置里关了 xpack.security.enabled —— 因为 v8 客户端默认发带Authorizationheader 的请求，没凭据就直接 401 - 本地 Docker 单节点启动时，
discovery.type=single-node必须设置，否则es.Info()可能卡住或返回503 Service Unavailable
Index 文档时 ID 怎么设才不翻车
v8 彻底移除了 type 概念，文档 ID 不再靠 type 区分，所以 ID 的生成逻辑得自己兜底。别依赖 es.Index().Id("") 让 ES 自动生成——它返回的 ID 是 base64 编码的随机串，不利于调试和幂等更新。
- 业务主键（如
order_id、user_id）直接当Id最稳妥，查、删、更新都能精准命中 - 如果必须自动生成，用
es.Index().Id(uuid.NewString())，别用time.Now().UnixNano()——高并发下可能重复 - 调用
Index()后务必检查res.IsError()，而不是只看err == nil；ES 返回 200 但 body 里"result":"noop"或"error"字段也常见
最常被忽略的是：ES 8 的 Index() 接口返回值是 *esapi.IndexResponse，不是 map[string]interface{}，想取 _id 得解析 res.Body，不是直接点字段。这点在日志打点或重试逻辑里特别容易漏掉。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
