应使用官方 go-elasticsearch/v9 客户端，禁用 olivere/elastic；其不提供 elastic.BoolQuery，布尔查询需通过 JSON 字符串、类型化 API（*types.Query）或 esdsl 构建器实现，三者不可混用。
go-elasticsearch 官方客户端不提供 elastic.BoolQuery 这个类型 —— 那是旧版第三方库 olivere/elastic 的写法，已废弃多年。用错包会导致编译失败、类型不匹配、API 调用无声失败等隐蔽问题。
确认你用的是官方 go-elasticsearch/v9，不是 olivere/elastic
检查 go.mod：正确应为 github.com/elastic/go-elasticsearch/v9；若看到 gopkg.in/olivere/elastic.v7 或类似，立刻替换。两者 API 完全不兼容：olivere 的 elastic.NewBoolQuery() 在官方客户端里根本不存在。
- 官方客户端没有
BoolQuery构建器类，所有查询都通过结构体字段或 JSON 字符串表达 - 官方 v9 不再维护 “query builder” 风格的链式调用（那是
esdsl模块提供的可选能力） - 如果你正在抄网上 2020–2022 年的博客或 GitHub Gist，大概率用的是已归档的
olivere库
官方 v9 三种合法方式：选一种坚持用
官方客户端提供三类 API 风格，布尔查询必须按对应方式组织：
-
低级 API（最常用）：手写 JSON
bool查询体，用strings.NewReader()包裹后传给client.Search.WithBody()。适合调试、复用已有 ES 查询逻辑、或快速验证 -
完全类型化 API（推荐用于核心业务）：用
es.Search().Request(&search.Request{...})，其中Query字段填入*types.Query结构体。类型安全，IDE 可补全，但嵌套深时代码略冗长 -
esdsl构建器（语法最简洁）：需额外导入github.com/elastic/go-elasticsearch/v9/typedapi/esdsl，用esdsl.Bool()链式构建。注意：它生成的是*types.Query，最终仍要塞进类型化 API 调用中，不能直接传给低级 API
混用这三种风格会导致结构体字段被忽略、WithBody 和 Request 冲突、或 esdsl 对象无法序列化等问题。
Alibabacloud Sdk Client Initialization For Golang
下载
初始化并管理阿里云SDK Go 客户端，涵盖 sync.Once 单例、goroutine 安全、endpoint 与 region 配置、VPC 端点及调试。
立即学习“go语言免费学习笔记（深入）”；
must + should + filter 混合时的典型陷阱
ES 布尔查询的子句行为差异直接影响结果和性能，Go 客户端不会帮你校验逻辑是否合理：
-
must和should子句默认都参与算分；若你只想过滤（比如日期范围、状态值），必须用filter，否则会拖慢查询且干扰排序 - 当只有
should子句、没有must或filter时，ES 默认要求至少匹配一个（minimum_should_match: 1）；但如果你加了must，should就变成“加分项”，即使全不匹配也能返回结果 —— 这常导致漏数据 - 对
nested字段做should查询时，必须用esdsl.Nested()或手动写"nested": {"path": "...", "query": {...}}，直接把 match query 塞进 should 会查不到任何内容 - 中文模糊查别用
wildcard：它不走分词，对text字段基本无效；应改用match_phrase_prefix或multi_match+type: "phrase_prefix"
嵌套 bool 查询怎么写才不出错
想表达 “(A AND B) OR (C AND D)” 这种逻辑，不能靠一层 bool 的 should 直接塞四个 match —— 那实际是 A OR B OR C OR D。
- 必须用
should包含两个独立的bool子句，每个子句内用must组合条件 - 在类型化 API 中，就是
Should: []*types.Query{ { Bool: &types.BoolQuery{ Must: [...] } }, { Bool: &types.BoolQuery{ Must: [...] } } } - 在
esdsl中，是esdsl.Bool().Should(esdsl.Bool().Must(...), esdsl.Bool().Must(...)) - 低级 API 则老老实实写两层 JSON：
"should": [{"bool": {"must": [...] }}, {"bool": {"must": [...] }}]
漏掉任意一层 bool 包裹，ES 就会报 parse_exception 或静默返回空结果 —— 这类错误在日志里不报错，只返回 0 条命中的文档。
