必须用匹配版本的go-elasticsearch/v8连接ES 8.x集群，否则报400或401；默认启用HTTPS与API key认证，需显式配置Username/Password及TLS Transport，禁用安全则加xpack.security.enabled=false。
用 go-elasticsearch/v8 连接 8.x 集群必须匹配版本
不匹配就报 400 Bad Request 或 401 Unauthorized，不是网络问题，是协议层不兼容。Elasticsearch 8.x 默认启用 HTTPS 和基于 API key 的认证，go-elasticsearch/v8 客户端默认走 HTTP，且不自动携带 Authorization 头。
- 本地开发用 Docker 启动 ES 8.x 时，必须显式关闭安全特性，或配置 TLS 和凭证：启动命令里加
-e xpack.security.enabled=false - 如果保留安全机制，客户端初始化要传
elasticsearch.Config{ Username: "elastic", Password: "xxx", Transport: ... }，且Transport需包装http.Transport支持自签名证书（否则报x509: certificate signed by unknown authority） - 别混用
v7和v8客户端——v7调8.x会卡在GET /_cat/health返回空响应，因为 v8 移除了部分 legacy endpoint
Index() 和 Search() 调用前必须确认 mapping 已就绪
ES 不强制预定义 mapping，但 Go 客户端写入时若字段类型推断错误（比如把数字当字符串索引），后续 range 查询直接失效，且无明确报错。
- 首次写入前，手动 PUT 一个 mapping 比依赖 dynamic mapping 更可靠，尤其对时间字段：
"created_at": { "type": "date", "format": "strict_date_optional_time||epoch_millis" } -
Index()方法里没传elasticsearch.Index.WithRequireAlias(true)之类参数，不代表它不校验——如果目标 index 不存在，Index()会成功创建，但用的是 default mapping，text 字段默认开启分词，term 查询就查不到 - 搜索时发现
term查不到数据？先用GET /your_index/_mapping确认字段类型，text 字段要用match，keyword 字段才用term
实时性陷阱：refresh_interval 和 bulk 写入的取舍
刚 Index() 一个文档，立刻 Search() 却查不到，不是代码 bug，是 ES 默认 1 秒 refresh 周期。语言学习类场景（如用户输入即搜）必须干预。
- 开发环境可临时设
"refresh_interval": "100ms"，但上线后切回"30s"或"-1"（禁用自动 refresh），靠client.Indices.Refresh()手动触发 - 批量导入用
Bulk()时，别省略elasticsearch.Bulk.WithRefresh("wait_for")参数，否则 bulk 返回 success，但文档仍不可搜 - 高频小文档写入（如用户打字日志），用
Refresh(true)参数强制单次刷新，但会拖慢吞吐——每秒超过 20 次就该考虑异步 bulk + 定时 refresh
中文分词必须自己配 IK 插件，go-elasticsearch 不处理这个
客户端只发请求，分词逻辑全在 ES 侧。Go 代码里传 "text": "自然语言处理"，如果 index 没装 IK，ES 默认用 standard analyzer，结果是 ["自然", "语言", "处理"] → ["自", "然", "语", "言", "处", "理"]，搜“自然语言”必然失败。
立即学习“go语言免费学习笔记（深入）”；
- Docker 启动 ES 时挂载 IK 插件目录：
-v /path/to/ik:/usr/share/elasticsearch/plugins/ik，然后重启容器 - 建 index 时显式指定 analyzer：
"analyzer": "ik_max_word"，别依赖dynamic_templates - 验证分词效果用
POST /your_index/_analyze，不是看 Go 程序返回值——客户端根本不知道分词发生了什么
