Golang微服务与Elasticsearch的集成及搜索优化-Golang-PHP中文网

es 8.0+ 必须用 elastic/go-elasticsearch/v9，因协议断层导致 olivere/elastic/v7 连接失败；常见问题包括索引名非法、body 未用 bytes.newreader、context 缺超时、中文分词器未显式指定、multi_match 不支持字段 boost 语法、hit.source 需解引用、refresh 延迟及字段类型不匹配。

golang微服务与elasticsearch的集成及搜索优化

必须用 elastic/go-elasticsearch/v9，olivere/elastic/v7 在 ES 8.0+ 上根本连不上——不是代码写错了，是协议断层导致 400/406 或静默空响应。

为什么 esapi.SearchRequest 总是返回空 hits 或 panic

官方客户端不补默认值，漏设任一关键字段，ES 就当请求无效。常见错误组合：

Index 传了 "" 或 "*"：ES 8+ 拒收通配符索引名，生产环境必须显式传 []string{"blogs"}
Body 不是 *bytes.Reader：比如 json.Marshal() 后直接传 []byte，ES 收不到 body，返回 400；正确写法是 bytes.NewReader(data)
Context 没带超时：HTTP client 卡在连接池，goroutine 悬停不释放，现象是服务变慢、连接数暴涨

中文多字段加权搜索总不生效

不是 query 写得不对，而是 ES 默认用 standard 分词器查 IK 索引，或 boost 被 multi_match 层级吞掉。真实生效路径：

Golang Samber Do

使用 samber/do 在 Golang 中实现依赖注入 — 服务容器、生命周期管理、作用域、健康检查、优雅关闭和模块组织

下载

查询 DSL 必须显式指定 "analyzer": "ik_max_word"，且字段名与 mapping 完全一致（title ≠ Title）
别依赖 multi_match 的 fields: ["title^3", "content"]：v9 客户端不识别该语法，boost 只在 multi_match 内部起作用
真要 title 权重高 3 倍，得用 BoolQuery + Should 数组，每个 match 单独设 boost，例如：map[string]interface{}{"match": map[string]interface{}{"title": map[string]interface{}{"query": "golang", "boost": 3.0}}}
加 "explain": true 到请求 body，返回里会带评分拆解，否则看不出是分词错还是 boost 没加载

解析 hit.Source 时 panic 或字段为空

ES 返回的文档内容在 hit._source 下，不是 JSON 根对象。直接 json.Unmarshal(raw, &MyDoc{}) 必然失败。

hit.Source 是 *json.RawMessage 类型指针，必须先解引用：*hit.Source
正确解码姿势：err := json.Unmarshal(*hit.Source, &doc)，注意前面的 *
如果字段类型不匹配（比如 mapping 里 title 是 keyword，却用 MatchQuery 查），也会导致 hit.Source 为空或字段丢失