必须在搜索调用点显式 try/catch 捕获 yii\elasticsearch\exception，检查 rawresponse 中 error 字段，开发环境透传详情、生产环境返回友好提示，并绕过日志延迟直写 error_log 确认异常捕获。
搜索请求抛出异常时页面直接 500 怎么办
Yii2 中 Elasticsearch 查询失败默认不透出错误信息，而是触发 Fatal error 或静默返回空结果，根本原因是未捕获底层客户端异常，且错误处理器没接管搜索上下文。必须在调用点显式 try/catch，不能依赖全局 errorHandler 自动处理。
- 所有对
$model::find()->search()、$connection->createCommand()->search()等搜索操作，都得包在try块里 - 捕获的异常类型必须是
yii\elasticsearch\Exception或其父类yii\base\Exception，不能只写Exception（PHP 原生异常无法携带 ES 错误码） - ES 连接超时、节点不可达、DSL 语法错等都会抛出该异常，
$e->getMessage()通常含Connection refused或parse_exception等关键线索
搜索无结果但也不报错，怎么确认是不是 ES 层面失败
常见假象是“没搜到 = 没问题”，实际可能是查询被 ES 拒绝后降级为空数组，用户看不到任何提示。必须检查返回值结构是否符合预期，而非只判空。
- 用
var_dump($dataProvider->getModels())看结果数组内容，若为array(0) { }但$dataProvider->totalCount === 0，再查$dataProvider->query->getRawResponse() -
getRawResponse()返回原始 JSON 数组，重点看是否有error字段或status不等于200 - 若
rawResponse['error']['reason']存在，说明 ES 已明确拒绝请求（如 mapping 字段类型不匹配），这时应把$rawResponse['error']['reason']显示给开发人员，而不是用户
如何把 ES 错误安全地透传给前端用户
直接输出 ES 原始错误信息有风险（暴露集群路径、版本、内部字段名），需做两级过滤：开发环境显示详情，生产环境只给友好提示。
- 在控制器中判断
YII_DEBUG：开发时$this->render('search', ['error' => $e->getMessage()])；生产时统一返回'搜索服务暂时不可用，请稍后再试' - 避免在视图里拼接
$error到 HTML，改用Yii::$app->session->setFlash('error', $friendlyMsg)，再在布局中用Yii::$app->session->getFlash('error')渲染 - 若使用 AJAX 搜索，后端响应必须带明确状态码：
return $this->asJson(['success' => false, 'message' => $friendlyMsg])，前端根据success字段控制 UI 提示
为什么加了 try/catch 还看不到错误提示
最常踩的坑是错误被中间件或日志组件提前吞掉，尤其是启用了 log 组件且配置了 flushInterval 时，异常记录会延迟写入，导致调试时以为没触发。
- 检查
config/web.php中log组件的targets是否包含file类型，且levels包含error - 临时在
catch块里加error_log('[ES] ' . $e->getMessage(), 3, '/tmp/es-error.log')，绕过 Yii 日志系统直写文件，确认异常确实被捕获 - 若用的是
yii\elasticsearch\ActiveRecord::find()->search()，注意它内部已封装了一层异常，$e->getPrevious()可能才是原始 cURL 错误，别忽略
MultiSearch）和聚合查询（aggs），它们的错误结构和单次查询不同，getRawResponse() 返回的是数组套数组，必须逐项检查 responses[n]['error']。
