Go连接Elasticsearch需处理TLS验证、v7/v8 API差异、mapping结构错位及HTTP状态码检查，否则生产环境易现401、x509、timeout或查无结果。
Go 连接 Elasticsearch 不是“配个地址就能用”的事，真正卡住上线的是 TLS 验证、v7/v8 API 差异、mapping 结构错位和 HTTP 状态码忽略——这些不处理，NewClient 跑通 demo 后，一上生产就 401、x509、timeout 或索引查不到结果。
连接时地址和协议写错，连都连不上
常见错误不是代码写得不对，而是地址字符串本身触发了重定向或协议降级：
-
Addresses: []string{"http://localhost:9200/"}→ 末尾斜杠会导致某些版本客户端发起 301 重定向，而 ES 默认不支持重定向，直接失败；应写成"http://localhost:9200" -
Addresses: []string{"localhost:9200"}→ 缺协议头，部分 v7 客户端会“猜”成 http，但 v8 明确报错；必须显式写"http://"或"https://" - Docker 场景下，ES 启动没加
http.host: "0.0.0.0"，只绑localhost，Go 客户端从宿主机或另一容器连就会超时（哪怕地址、端口全对）
HTTPS + Basic Auth 必须配 Transport，不能只填 Username/Password
Username 和 Password 字段只负责往 Header 写 Authorization: Basic ...，完全不管证书校验。不配 Transport，99% 的 HTTPS 生产集群都会报 x509: certificate signed by unknown authority：
- 跳过证书验证（仅测试）：
Transport: &http.Transport{TLSClientConfig: &tls.Config{InsecureSkipVerify: true}} - 加载 CA 证书（推荐）：
TLSClientConfig: &tls.Config{RootCAs: x509.NewCertPool()}，再用ioutil.ReadFile读证书内容调用AppendCertsFromPEM - v8 客户端默认启用更严格的 TLS 检查，v7 可能“侥幸”通过，但别依赖——v7/v8 的
Config字段名一样，行为已不同
v7 和 v8 的 mapping 结构不兼容，写错就创建成功但搜不到
Go 客户端不带 DSL 构建器，mapping 得手写 JSON。v7 允许 "mappings": { "_doc": { "properties": { ... } } }，v8 已彻底移除 type，结构必须扁平：
- v8 正确写法：
"mappings": { "properties": { "title": { "type": "text", "analyzer": "ik_max_word" } } } - v7 错误写法（v8 直接拒收）：
"mappings": { "_doc": { "properties": { ... } } } -
Indices.Create().WithBody()参数必须是io.Reader，传字符串会静默失败；要用strings.NewReader(mappingJSON) - 中文分词器如
ik_max_word必须提前装到 ES 节点，Go 端只负责写进 mapping 字段；名字拼错（比如写成ik_maxworld），索引创建成功，但搜索永远无结果
写入 time.Time 字段时格式不统一，日期解析直接崩
ES 对 date 字段默认用 strict_date_optional_time 解析，它要求输入严格匹配 yyyy-MM-dd'T'HH:mm:ss.SSSZZ 格式：
- 如果数据里混着
"2024-01-01"和"2024-01-01T00:00:00Z"，前者会被当成字符串字段存，后者才进 date 字段——查范围时全失效 - 稳妥做法：写入前统一转成 RFC3339（
t.Format(time.RFC3339)），或在 mapping 里显式定义多格式："format": "strict_date_optional_time||date||epoch_millis" - 别依赖 Go 的
time.Time序列化行为，ES 不认 Go 的 MarshalJSON 逻辑；必须自己控制输出字符串
最常被忽略的其实是 HTTP 状态码检查——client.Index().Do(ctx) 返回 err == nil 不代表写入成功，ES 可能返回 200 但 body 里是 {"error": {...}}；所有写操作后建议手动检查响应里的 result 或 errors 字段。
