Fiber 没有官方 Elasticsearch 客户端，必须手动集成 go-elasticsearch SDK；因其轻量无 DI 容器、无自动装配机制，不支持 Spring Boot 风格的 starter 依赖，所有连接、查询、错误处理均需自行实现。
直接说结论：Fiber 没有官方 Elasticsearch 客户端，必须用 Go 原生 elasticsearch 官方 SDK（github.com/elastic/go-elasticsearch）手动集成，不能像 Spring Boot 那样靠 starter 自动装配。
为什么 Fiber 无法像 Spring Boot 那样“自动整合”
Fiber 是一个轻量级 Go Web 框架，本身不提供 ORM、数据源管理或搜索客户端的生命周期抽象。它不内置依赖注入容器，也不定义 @Document、@Repository 这类语义注解。所有 Elasticsearch 连接、索引操作、错误重试、连接池管理都得你手写。
-
elasticsearch-goSDK 不含 HTTP 路由绑定逻辑，它只负责和 ES 节点通信 - Fiber 的
app.Get()、app.Post()和 ES 的es.Search()是完全解耦的两层 - 没有
spring-boot-starter-data-elasticsearch对应物，别在go.mod里搜 “fiber-elasticsearch” —— 那些第三方包基本是简单封装，不可靠且不维护
正确初始化 client 的关键配置项
ES 8.x 默认启用 HTTPS 和基于 API Key 的认证，本地开发若关了安全特性（xpack.security.enabled: false），仍需显式禁用证书校验；否则会卡在 connection refused 或 tls: failed to verify certificate。
- 用
elasticsearch.NewDefaultClient()前，先检查ELASTICSEARCH_URL环境变量是否为http://localhost:9200（不是https） - 若用自签名证书或跳过验证，必须传入
elasticsearch.Config{Transport: &http.Transport{...}}，并设置TLSClientConfig: &tls.Config{InsecureSkipVerify: true} - 超时必须设：默认
http.Client没有超时，请求 hang 住会拖垮整个 Fiber 应用 - 示例片段：
cfg := elasticsearch.Config{
Addresses: []string{"http://localhost:9200"},
Transport: &http.Transport{
TLSClientConfig: &tls.Config{InsecureSkipVerify: true},
},
Username: "elastic",
Password: "changeme",
}
client, err := elasticsearch.NewClient(cfg)
if err != nil {
log.Fatal(err)
}
在 Fiber 路由中安全使用 ES client
ES client 是并发安全的，但不能每次请求都 new 一个。必须作为全局变量或通过 Fiber 的 app.Use() 注入上下文，否则会快速耗尽文件描述符或连接数。
- 错误做法：
func handler(c *fiber.Ctx) { client := es.NewClient(...) }—— 每次新建 client，底层 TCP 连接不复用 - 推荐做法：在
main()初始化一次，用app.Get("/search", searchHandler(client))闭包传入 - 或者用
fiber.Map存进c.Locals，但仅限读取配置等轻量场景；真实查询必须用共享 client 实例 - 注意
client.Search()返回的是*esapi.SearchResponse，要手动json.NewDecoder(res.Body).Decode(&out)，别指望自动 JSON 绑定
容易被忽略的兼容性雷区
ES 8.x 移除了 type 概念，所有文档都属于 _doc 类型；而很多旧教程或 Go 示例还在用 Index: "my-index", Type: "product"，这会导致 400 Bad Request: Types are deprecated 错误。
- 创建索引时不要写
Type字段，PUT /my-index即可 - 插入文档用
POST /my-index/_doc（不是/my-index/product/_doc） - 查询时 URL 是
GET /my-index/_search，body 用match或match_phrase，别再找query_string里塞default_field这种 6.x 语法 - Go SDK 中对应方法是
client.Index()和client.Search()，参数结构体里没有Type字段 —— 如果你看到有，说明 SDK 版本太老（如 v7.x 以下）
版本对齐是硬门槛：ES 8.14 要配 github.com/elastic/go-elasticsearch/v8，混用 v7 SDK 会静默失败或返回空结果。
