应使用 github.com/elastic/go-elasticsearch/v8 官方客户端，初始化需配置 transport 调优（maxidleconns/perhost≥100、timeout）、精确匹配 mapping 字段名、手动解析 hits 和 aggregations，避免 dsl 错误、类型不匹配、连接池耗尽及聚合路径错误。
Go 里直接用 elasticsearch 官方客户端就能做全文搜索，不需要额外封装层，但必须手动构造查询 DSL、处理响应结构、注意连接池和错误重试——否则容易查不到数据或服务假死。
用 elastic/v8 初始化客户端并连上集群
官方推荐用 github.com/elastic/go-elasticsearch/v8（v7 不再维护），初始化时别漏掉 http.Transport 调优，否则高并发下会卡在连接等待：
-
MaxIdleConns和MaxIdleConnsPerHost建议设为 100+，默认是 2 - 务必设置
Timeout，否则网络抖动时请求可能卡住几十秒 - 如果 ES 启用了 HTTPS 且用自签名证书，需显式传入
http.Client并禁用证书校验（仅测试环境）
示例：
cfg := elasticsearch.Config{
Addresses: []string{"https://localhost:9200"},
Transport: &http.Transport{
MaxIdleConns: 100,
MaxIdleConnsPerHost: 100,
IdleConnTimeout: 30 * time.Second,
},
Username: "elastic",
Password: "changeme",
}
es, err := elasticsearch.NewClient(cfg)
构造 match 查询时字段名必须精确匹配 mapping
ES 不会自动转换字段名大小写或下划线，比如 mapping 里定义的是 product_name，但你在 match 查询里写了 productName，结果就是空。常见坑：
- 没提前确认索引 mapping，靠猜字段名
- 用
dynamic: true写入数据后字段类型被推断成text，但后续想按 keyword 精确匹配就失败 - 中文分词没配 IK 插件，
match查“笔记本电脑”只返回含“笔记”或“电脑”的文档
查之前先跑一遍：GET /your-index/_mapping，确认字段类型和 analyzer。
用 Search 方法执行查询并解析 Hits
Search 返回的是原始 JSON，Go 客户端不会自动反序列化成业务结构体，得自己定义 Hit 和结果结构：
- 响应里的
hits.hits是[]map[string]interface{}，建议用json.Unmarshal显式转成结构体 - 别直接读
hit["_source"]，它可能是nil（比如设置了_source: false） - 分页靠
From和Size，但深度分页（From > 10000）会触发query_then_fetch性能问题，改用search_after
简例：
res, err := es.Search(es.Search.WithIndex("products"), es.Search.WithBody(bytes.NewReader(q)))
var r map[string]interface{}
json.NewDecoder(res.Body).Decode(&r)
hits, _ := r["hits"].(map[string]interface{})["hits"].([]interface{})
for _, h := range hits {
src := h.(map[string]interface{})["_source"].(map[string]interface{})
fmt.Println(src["product_name"])
}
聚合结果要手动展开 aggregations 字段
全文搜索常附带分类统计，比如按品牌聚合。ES 返回的聚合在 aggregations 下，不是 hits 里：
- 聚合名称（如
"brand_agg"）必须和请求 DSL 里写的完全一致 - 桶（bucket）数组在
brand_agg.buckets，每个桶是map[string]interface{}，含key和doc_count - 嵌套聚合要逐层取键，比如
aggs.brand_agg.buckets.0.sub_agg.buckets，容易 panic，建议用gjson或写辅助函数安全取值
没处理好聚合路径，就会看到 panic: interface conversion: interface {} is nil, not []interface {}。
DSL 写错、字段类型不匹配、连接池耗尽、聚合路径写串——这四类问题占了实际调试时间的 80%，比算法逻辑更常卡住进度。
