应使用 go-elasticsearch 官方客户端，禁用 sniff 并设置超时；bulk 写入用 esutil.bulkindexer；查询时 filter 用于无评分过滤，query 用于相关性检索；reindex 需关闭 scripting 限制并避免轮询任务状态。
直接用 go-elasticsearch，别碰已归档的 olivere/elastic —— 后者 v7 版本不兼容 ES 8.x，v8+ 官方已停止维护，新项目踩坑率接近 100%。
初始化 client 时必须禁用 sniff 和设置超时
在 Docker 或单节点开发环境里，sniff 会主动探测集群其他节点（比如尝试连 http://172.18.0.3:9200），但本地容器网络通常只暴露 localhost 或宿主机 IP，结果就是连接卡住、报 connection refused 或 i/o timeout。
正确做法是显式关闭 sniff，并设好超时：
client, err := elasticsearch.NewClient(elasticsearch.Config{
Addresses: []string{"http://localhost:9200"},
Transport: &http.Transport{
MaxIdleConnsPerHost: 128,
ResponseHeaderTimeout: 30 * time.Second,
},
// 关键：禁用自动节点发现
DiscoverNodesOnStart: false,
})
-
DiscoverNodesOnStart: false是必须项，不是可选 - 如果用 ES Cloud，地址要带完整 endpoint（如
https://xxx.us-east-1.aws.found.io:9243），且必须配transport支持 TLS - 生产环境建议加
RetryOnStatus: []int{502, 503, 504}，避免网关抖动导致请求直接失败
bulk 写入别手写 for 循环，用 esutil.BulkIndexer
手动拼 BulkRequest + Do() 容易内存泄漏、并发错乱、错误难捕获。官方 esutil.BulkIndexer 内置缓冲、重试、并发控制，实测吞吐能提 3–5 倍。
常见误配置：
-
FlushBytes: 1e+6（1MB）太小 → 小文档多时频繁 flush，CPU 毛刺明显 -
Concurrency: 1→ 完全没发挥批量优势，纯串行 - 漏掉
Close()→ 最后一批数据可能滞留在 buffer 里不发出
推荐配置（中等负载）：
bi, _ := esutil.NewBulkIndexer(esutil.BulkIndexerConfig{
Client: client,
Index: "logs",
Concurrency: 4,
FlushBytes: 5e+6, // 5MB
FlushInterval: 10 * time.Second,
})
// ... 写入
bi.Close(context.Background()) // 必须调用
查询 DSL 错误：filter 和 query 混用导致评分失真
写 bool 查询时，把时间范围、状态码这类非相关性条件塞进 query 分支，会让所有匹配文档强行参与 TF-IDF 计算，不仅慢，还会让“最新”或“高优先级”文档排不到前面。
正确结构是：
- 影响排序和相关性的字段（如标题、正文关键词）放
query - 纯粹过滤作用的字段（如
status: "published"、@timestamp > now-7d）必须放filter - ES 8.x 起
type已废弃，match_all等基础查询无需额外包装
示例（Go 中构建）：
search, _ := client.Search().Index("articles").
Query(elastic.BoolQuery().
Must(elastic.MatchQuery("title", "golang")).
Filter(
elastic.TermQuery("status", "published"),
elastic.RangeQuery("@timestamp").Gte("now-30d"),
),
).Do(ctx)
reindex 迁移索引时，别在代码里轮询任务状态
Go 调用 _reindex API 返回的是一个异步任务 ID（如 12345:123），很多人习惯用 TaskGet 循环查状态，直到 completed: true。这既浪费连接又容易超时断连。
更稳的方式是：
- 调用
Reindex时加WaitForCompletion(false)，让它后台跑 - 用
TasksList查任务详情，重点看running和throttled字段 - 真正要感知完成，监听目标索引的
docs.count是否趋近源索引（用IndicesStats获取）
注意：reindex 不支持跨集群直连（除非开了 reindex.remote.whitelist），本地调试务必确认源/目标集群网络互通。
最常被忽略的一点：ES 8.x 默认关闭 scripting，但 reindex 的 script 参数、update_by_query 都依赖它。不提前在 elasticsearch.yml 加 script.allowed_types: inline，操作会静默失败。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
