最稳的 ES 客户端是官方 elastic/v8；resty 需手动处理 DSL 和响应，易出错；olivere/elastic.v7 已归档且不兼容 ES 8.x 安全默认。
用 resty 或 elastic/v8 客户端连 ES，别碰 gopkg.in/olivere/elastic.v7
Go 生态里最稳的 ES 客户端是官方维护的 github.com/elastic/go-elasticsearch/v8（v8 对应 ES 8.x），resty 也能用但得自己拼 DSL、解析响应，容易出错。老版本 olivere/elastic.v7 已归档，不兼容 ES 8.x 的安全默认（HTTPS+Basic Auth）、TLS 配置也更繁琐，新手直接绕开。
安装推荐客户端：
go get github.com/elastic/go-elasticsearch/v8
关键点：
- ES 8.x 默认启用
xpack.security.enabled: true，必须配用户名密码和 CA 证书（本地单节点测试可临时关掉，但代码里要留开关） -
elastic.NewDefaultClient()会读ELASTICSEARCH_URL环境变量，生产环境建议用elastic.Config{Addresses: []string{"https://es.example.com:9200"}, Username: "...", Password: "...", CertificateFingerprint: "..."} - 连接失败常见报错：
connection refused（端口没开或 network.host 没配对）、certificate signed by unknown authority（没传 CA 或 fingerprint 错）、invalid username or password（xpack 没关且没配 auth）
在 Iris 路由里调用 ES 查询，注意上下文传递和错误处理
Iris 的 Context 不是 Go 原生 context.Context，但可以转成带超时的原生 context 传给 ES 客户端，避免请求卡死。别直接用 ctx.Request().Context()，它没超时控制。
示例片段（搜索商品标题）：
app.Get("/search", func(ctx iris.Context) {
q := ctx.URLParam("q")
if q == "" {
ctx.StatusCode(400)
ctx.WriteString("missing 'q'")
return
}
// 构建带 5s 超时的 context
esCtx, cancel := context.WithTimeout(context.Background(), 5*time.Second)
defer cancel()
res, err := es.Search(
es.Search.WithContext(esCtx),
es.Search.WithIndex("products"),
es.Search.WithBody(strings.NewReader(fmt.Sprintf(`{"query": {"match_phrase": {"title": "%s"}}}`, q))),
es.Search.WithFrom(0),
es.Search.WithSize(10),
)
if err != nil {
ctx.StatusCode(500)
ctx.WriteString("es query failed: " + err.Error())
return
}
defer res.Body.Close()
// 解析 hits 到 []map[string]interface{}
var r map[string]interface{}
json.NewDecoder(res.Body).Decode(&r)
ctx.JSON(r)
})
注意：
-
es.Search.WithBody必须传*strings.Reader，不能传字符串字面量 - ES 返回的
res.Body是io.ReadCloser，不关会泄露 HTTP 连接 - 如果要用结构体反序列化（比如
ProductDoc），得先解析外层hits.hits数组，再逐个 decode，别试图一气呵成
高亮、分页、聚合这些功能，全靠 DSL 写对，不是 Iris 控制的
Iris 只负责 HTTP 入口和响应包装，全文检索的语义（高亮字段、分页偏移、按品牌聚合）全在发给 ES 的 JSON body 里。写错一个 key 名（比如把 highlight 写成 highlights），ES 就静默忽略，返回结果没高亮还不报错。
常用 DSL 片段参考：
{
"query": {
"multi_match": {
"query": "iphone",
"fields": ["title^3", "description"]
}
},
"highlight": {
"fields": {
"title": {},
"description": {}
}
},
"aggs": {
"by_brand": {
"terms": { "field": "brand.keyword" }
}
}
}
要点：
- 高亮字段必须是
text类型且开了"index_options": "offsets"，否则返回空highlight字段 - 聚合字段（如
brand）要用.keyword子字段，原始text字段无法做 terms 聚合 - 分页慎用
from + size超过 10000 条，改用search_after或pit（Point in Time）
ES 8.x 的 TLS 和认证配置最容易漏，本地调试也得模拟真实链路
很多人在 Docker 里跑单节点 ES 8.x，以为关了 xpack 就万事大吉，结果 Iris 服务一连就报 net/http: request canceled (Client.Timeout exceeded while awaiting headers)。其实是 ES 8.x 即使关了 security，仍强制走 HTTPS（除非显式设 elasticsearch.ssl.verification_mode: none 并用 HTTP 地址）。
稳妥做法：
- 开发环境：ES 启动加
-E xpack.security.enabled=false -E http.port=9200 -E transport.port=9300 -E network.host=0.0.0.0，Iris 直连http://localhost:9200 - 预发/生产：ES 开 xpack，Iris 用
elastic.Config配Username/Password和CertificateFingerprint（从 ES 日志里复制），别省这一步 - 别信“本地 curl 能通，代码就连不上”——curl 默认忽略证书校验，Go 客户端默认严格校验
真正卡住人的，从来不是 Iris 怎么写路由，而是 ES 的 TLS 握手失败、DSL 字段名大小写写反、或者聚合字段忘了加 .keyword 后缀。这些细节不验证到返回体里，光看代码逻辑永远发现不了。
