webman集成elasticsearch实现毫秒级响应的关键在于规避连接滥用、分词器错配、查询结构低效三类问题；需用v8客户端+ik分词+match_phrase，严格配置超时重试、ssl校验、容器网络、版本对齐、mapping预设及查询优化。
Webman 集成 Elasticsearch 想做到毫秒级响应，核心不在“加机器”或“堆配置”，而在于绕过常驻进程下的连接滥用、分词器错配、查询结构低效这三类隐形卡点。v8 客户端 + IK 分词 + match_phrase 组合能压到 20ms 内，但前提是初始化不踩坑、查询不写死、索引不裸建。
ClientBuilder::create() 初始化必须显式设 timeout 和 retries
默认 30 秒超时在协程环境下是灾难——一个慢请求会阻塞整个 worker，且 v8 客户端默认不重试 429/503。Swoole 下静默失败比报错更难排查。
-
setConnectionParams(['timeout' => 5.0, 'connect_timeout' => 3.0])是硬性要求，不能省略 -
setRetries(3)必须开启，否则集群临时抖动直接返回空结果 -
setSSLVerification('/path/to/ca.crt')生产环境禁用 false，Swoole 下证书校验失败会静默断连，curl_init手写调用也一样 - Docker 环境 hosts 别写
localhost:9200，得用容器名如http://elasticsearch:9200
IK 分词器必须与 ES 服务端版本严格对齐
ES 8.15.1 就只能装 elasticsearch-analysis-ik-8.15.1，差一个小版本就会报 406 Not Acceptable。这不是插件问题，是 ES v8 的 Accept 头校验变严了。
Webman 2.2.0版本强化了 TCP/UDP 服务支持，优化路由组管理，并增强异步任务处理能力。结合协程与连接池技术，Webman 能轻松应对高并发场景，适用于网站、接口服务、即时通讯、物联网及游戏开发，兼具高性能、灵活扩展与稳定可靠，是多场景 PHP 服务开发的理想选择。
- Windows 下运行
bin/elasticsearch-plugin install前，先确认elasticsearch -V输出的精确版本号 - mapping 中字段要用
"analyzer": "ik_max_word"，别漏掉引号——PHP 数组转 JSON 后没引号会变成无效字符串 - 测试分词效果用
_analyzeAPI：POST /your_index/_analyze?analyzer=ik_max_word，别只信文档示例
搜索请求体必须用 filter + match_phrase 替代简单 match
单纯 match 会触发相关性算分（TF-IDF），在高并发下 CPU 拉满；match_phrase 走倒排索引短语匹配，快 3–5 倍，且天然支持中文连词。
- 过滤条件一律走
"query": {"bool": {"filter": [...]}}，别混进must，filter不参与算分、可缓存 - 高亮必须限定字段：
"highlight": {"fields": {"title": {}}}，否则全量字段高亮会拖慢 200ms+ - 禁止
"_source": true，明确指定需要的字段，例如"_source": ["id", "title", "created_at"] - 深度分页超过 1000 条必须切到
search_after，from/size在大数据量下必然超时
索引创建前必须预设 mapping 并关闭 refresh_interval
Webman 是常驻进程，索引不能靠运行时自动创建（会触发 dynamic mapping，字段类型错配后无法修正）。上线前必须用 DSL 显式 PUT mapping，且 bulk 导入时临时关刷新。
- 创建索引时加
"settings": {"refresh_interval": "-1"}，导入完再POST /index/_refresh - text 字段必须同时定义
keyword子字段，排序和聚合只认title.keyword，不是title - 时间字段用
"type": "date"并指定format，PHP 传"2026-05-22T16:10:00+08:00"格式最稳 - 别信“先跑起来再优化”，mapping 错一次，重建索引 + reindex 至少停服 20 分钟
真正卡住毫秒级响应的，往往不是查询本身，而是连接池耗尽后新建连接的三次握手、IK 分词器加载失败导致 fallback 到 standard、或者一个未 catch 的 Elasticsearch\Common\Exceptions\NoNodesAvailableException 让整个协程挂起。这些点不提前压测，上线后只能看监控等超时告警。
