Beego中需用官方PHP客户端单例初始化ES，配置认证与SSL，显式定义IK分词mapping，搜索时用json.RawMessage解析_source，禁用refresh避免性能问题。
Beego 框架本身不内置 Elasticsearch 支持，直接用 httplib 手写请求虽能跑通，但极易在连接复用、错误重试、JSON 解析、超时控制上翻车。真正可用的集成，必须绕过裸 HTTP 封装，改用官方 PHP 客户端（elasticsearch/elasticsearch）并适配 Beego 的生命周期管理。
Beego 中怎么初始化 Elasticsearch 客户端
别在每个 controller 里重复 ClientBuilder::create()，客户端应作为单例注入到 Beego 应用上下文。否则连接池无法复用，高并发下会快速耗尽 socket 或触发 ES 的 connection limit。
- 在
app/conf/app.conf中配置 ES 地址与认证信息，例如：es.hosts = ["http://elasticsearch:9200"]、es.username = "elastic"、es.password = "changeme" - 在
app/controllers/init.go或自定义init()函数中构建客户端，并挂载到beego.App：beego.App.Config.Set("es_client", client) - 务必调用
setBasicAuthentication()或setApiKey()；ES 8.x 默认启用安全模块，无认证会返回401 Unauthorized - 开发环境可临时禁用 SSL 验证：
->setSSLVerification(false)，但生产环境必须传入 CA 路径，否则连接失败
索引 mapping 必须显式定义，不能靠 Beego 模型自动推导
Beego 的 orm 模块和 ES 无关，它不会、也不能把 models.User 自动转成 ES 的 mappings。中文字段若不指定分词器，哪怕数据写进去了，也搜不到。
- 建索引前必须手动执行
$client->indices()->create($params)，其中$params['body']['mappings']['properties']显式声明每个字段类型和分词器 - 中文字段如
title必须设为"type": "text"并指定"analyzer": "ik_smart"；若错设为"type": "keyword"，match查询永远为空 - ES 8.x 已移除
_type，别在 mapping 里写"_doc"或类似字段，否则报400 Bad Request - 验证分词效果用 curl：
curl -X GET "http://localhost:9200/my_index/_analyze" -H "Content-Type: application/json" -d '{"analyzer":"ik_smart","text":"微服务架构"}'
Beego Controller 里怎么安全执行搜索并解析结果
ES 返回的文档内容在 hit._source 下，不是顶层 JSON 对象。直接 json.Unmarshal(raw, &MyStruct{}) 会丢字段或 panic，尤其当字段名含下划线或大小写混用时。
- 用
json.RawMessage接收原始_source字段，再二次解析，避免结构体 tag 错配导致空值 - 查询 DSL 必须显式带
"analyzer"：如果索引用的是ik_max_word，match查询里也得加"analyzer": "ik_max_word"，否则 ES 默认走standard，中文切词完全对不上 - 分页别用
from/size做深度翻页（如from=10000），改用search_after+sort，否则触发index.max_result_window限制报错 - 高亮字段需在 query 中开启
"highlight"，并在响应里从hit.highlight取值，不是从_source里硬截
最常被忽略的是 refresh 行为：文档 index() 后默认 1 秒才可搜到。开发期加 "refresh": "true" 能看到结果，但上线后必须删掉——它会让写入性能暴跌，且批量导入时可能触发 bulk queue 拒绝。
