必须使用官方客户端 github.com/elastic/go-elasticsearch/v8（版本需与es服务端严格对齐），配置https地址、api key认证及ca证书（或跳过校验），并显式设置超时与重试机制。
用 go-elasticsearch/v8 连接 ES 8.x 集群
ES 8.x 默认启用 HTTPS 和基于 API key 的认证，olivere/elastic 已停止维护且不兼容 8.x，默认连接会直接报错 401 Unauthorized 或 connection refused。必须换用官方客户端 github.com/elastic/go-elasticsearch/v8。
安装时注意版本对齐：ES 8.5.3 就用 v8.5.3，不要写成 v8（会拉最新版，可能有 breaking change）：
go get github.com/elastic/go-elasticsearch/v8@v8.5.3
连接代码里要显式传入证书或跳过验证（开发环境可接受）：
- 若 ES 启用了 TLS（如通过 docker-compose 启动的默认 8.x 镜像），需配置
elasticsearch.Config{Transport: ...}并加载 CA 证书 - 本地快速验证可跳过证书校验：
http.Transport{TLSClientConfig: &tls.Config{InsecureSkipVerify: true}} -
SetURL("http://localhost:9200")在 8.x 下无效——默认是https://localhost:9200，端口也可能是9200（HTTP）或9201（HTTPS），得看你的启动参数
同步 MySQL 数据到 ES 的关键约束
用 go-mysql-elasticsearch 做实时同步，不是配完 config 就能跑通。MySQL 端几个硬性条件不满足，进程启动直接 panic：
- binlog 必须为
ROW模式，且binlog_row_image = FULL（否则增量日志缺失字段） - 同步表必须有主键；无主键的表会被完全忽略，日志里只打印 warning，不报错
- MySQL 用户至少要有
REPLICATION SLAVE、RELOAD、SUPER权限，光给SELECT不行 - 首次全量同步依赖
mysqldump，确保运行该工具的机器上已安装且在$PATH中
检查命令：SHOW VARIABLES LIKE 'binlog_format'; 和 SHOW VARIABLES LIKE 'binlog_row_image';，别只改 my.cnf 还忘了 FLUSH PRIVILEGES;。
Go 里定义 ES 文档结构要注意字段类型匹配
ES 不会自动转换类型，"123" 写进 integer 字段会直接 reject document，报错 mapper_parsing_exception。映射（mapping）必须提前建好，不能靠 dynamic mapping 猜。
比如任务系统中常见字段：
-
status建议用keyword（而非text），避免被分词，方便精确过滤 -
title和description用text，并配analyzer（如ik_max_word）做中文分词 -
created_at必须声明date类型和 format，例如"strict_date_optional_time||epoch_millis"，否则时间戳字符串无法解析 - 嵌套对象（如
tags数组）要用nested类型，普通object无法做 inner_hits 聚合
建索引时用 client.Index().Index("tasks").BodyString(mapping).Do(ctx)，mapping 是 JSON string，不是 Go struct —— 别试图用 json.Marshal 动态生成，容易漏引号或转义错误。
微服务里搜索请求的超时与重试控制
ES 查询失败不一定是集群挂了，更常见的是慢查询触发 circuit breaker、bulk 队列满、或网络抖动。在 Go 微服务里硬写 client.Search(...).Do(ctx) 很危险：
- 默认 context 没设 timeout，一次卡住就拖垮整个 HTTP handler
- ES 返回
503 Service Unavailable时，应主动重试（最多 2 次），但需加 jitter 避免雪崩 - 聚合查询（aggs）比 match 查询更耗资源，建议对高并发接口禁用深度聚合，或拆成两阶段：先查 ID 列表，再用
terms+ids查详情 - 用
ctx, cancel := context.WithTimeout(context.Background(), 2*time.Second)，别用context.Background()
ES 8.x 的 search API 默认返回 10 条，size 最大支持 10000，但深翻（from > 10000）性能断崖下跌，真要分页请用 search_after。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
