用elastic.NewClient()连不上ES，主因是v8客户端默认健康检查失败导致初始化阻塞或panic，应禁用Healthcheck并显式配置Addresses、HTTPS传输等。
用 elastic.NewClient() 连不上 ES？检查 Transport 和健康检查逻辑
Go 官方不维护 ES 客户端，主流是 olivere/elastic（v7）或 elastic/go-elasticsearch（v8+）。v8 客户端默认开启健康检查，启动时会发 HEAD / 请求，如果 ES 未就绪或网络不通，NewClient() 会直接 panic 或阻塞超时——不是连接失败，而是初始化失败。
实操建议：
立即学习“go语言免费学习笔记（深入）”；
- 用
elastic.Config{Addresses: []string{"http://localhost:9200"}, Healthcheck: false}关掉健康检查，自己控制重试 - v8 客户端必须显式传
elasticsearch.Config{Addresses: []string{"http://localhost:9200"}}，漏掉Addresses会导致空指针 panic - ES 启用了 HTTPS 但没配证书？加
elasticsearch.Config{Transport: &http.Transport{TLSClientConfig: &tls.Config{InsecureSkipVerify: true}}} - 别在
init()里初始化 client，容易触发 init 死锁；放到main()或依赖注入容器里
PutIndex() 报错 400 Bad Request？字段映射和索引设置不能混写
创建索引时，v7 的 PutIndex().BodyJson() 和 v8 的 indices.Create().Body() 都要求 JSON 结构严格符合 ES API 规范。常见错误是把 settings 和 mappings 写成同级字段，而实际要嵌套在 settings 和 mappings key 下。
实操建议：
立即学习“go语言免费学习笔记（深入）”；
- v7 示例：
client.CreateIndex("logs").BodyJson(map[string]interface{}{"settings": map[string]interface{}{"number_of_shards": 1}, "mappings": map[string]interface{}{"properties": map[string]interface{}{"msg": map[string]string{"type": "text"}}}}) - v8 示例：用
bytes.NewReader()包裹 JSON 字节，别用字符串直传，否则可能因转义出错 - 字段名含点号（如
user.id）？ES 默认不支持，得提前设"index.mapping.dynamic": false或用object类型包裹 - 想复用 mapping 模板？优先用
index templates，而不是每次建索引都手写 Body
批量写入用 BulkIndexRequest 还是 bulk.Indexer？看吞吐和错误粒度
v7 的 BulkIndexRequest 是单次请求封装，v8 的 bulk.Indexer 是带缓冲、重试、并发控制的工具类。选错会导致吞吐上不去，或错误定位困难。
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等
实操建议：
立即学习“go语言免费学习笔记（深入）”；
- 写入量小（BulkService 或 v8 的
bulk.Indexer.Flush()手动控制批次 - 高吞吐场景（日志、指标），必须用 v8
bulk.Indexer，它默认开 4 并发、自动分批（每批 1000 文档）、失败项进OnFailure回调 - 文档 ID 由业务生成？v7 要显式调
.Id("xxx")，v8 必须在文档 JSON 里带_id字段，否则 bulk 会自动生成，导致重复 - bulk 失败返回
413 Request Entity Too Large？调小Indexer.NumWorkers或Indexer.BytesPerBatch，ES 默认 http.max_content_length 是 100MB
删除旧索引别只靠 DeleteIndex()，先关副本再删更稳
直接 DeleteIndex("logs-2023-01") 在大集群上可能卡住，尤其当索引有大量分片且副本数 > 0 时，ES 要同步清理所有副本数据，期间可能触发 master node 负载飙升甚至超时。
实操建议：
立即学习“go语言免费学习笔记（深入）”；
- 删前先关闭索引：
client.CloseIndex("logs-2023-01")（v7）或indices.Close()（v8），减少元数据压力 - 删前临时降副本：
client.UpdateSettings().Index("logs-2023-01").BodyJson(map[string]interface{}{"number_of_replicas": 0})，删完再恢复 - 用通配符删一批索引？v7 支持
DeleteIndex("logs-2023-*")，v8 不支持，得先cat.Indices()拿列表再循环删 - 误删了？ES 没回收站，唯一办法是提前用
snapshot备份，且 snapshot 仓库路径权限常被忽略——确保 ES 进程有读写权限
索引生命周期管理（ILM）看起来省事，但 Go 客户端对 ILM API 封装弱，多数操作还得拼 JSON body，不如脚本 + cron 控制删索引时机来得直接可靠。
