Magento 2 搜索页突然返回错误，OpenSearch 或 Elasticsearch 响应 search_phase_execution_exception: all shards failed。这句话只表示参与当前查询的分片全部失败，并没有说明原因。真正可操作的信息在响应里的 root_cause 和每个 shard failure。
先确认是整个集群还是一个索引
SEARCH_ENDPOINT='搜索服务地址'
curl -sS \"$SEARCH_ENDPOINT/_cluster/health?pretty\"
curl -sS \"$SEARCH_ENDPOINT/_cat/indices?v\"
curl -sS \"$SEARCH_ENDPOINT/_cat/shards?v\"集群 red 表示至少有主分片不可用；yellow 在单节点环境可能只是副本未分配，不一定阻止查询。查找状态为 UNASSIGNED 的 Magento 索引，并通过 allocation explain 确认是节点离线、磁盘水位、分片数量还是版本兼容问题。
如果只有当前 Magento 索引异常，先识别实际索引前缀，不要删除整个搜索集群。一个服务可能同时承载多个站点或其他应用。
查看失败分片给出的具体异常
常见根因包括：查询了不存在或类型不兼容的字段、文本字段被用于不允许的排序/聚合、脚本错误、解析异常、损坏分片或节点断开。把 Magento 发送的请求与失败响应在搜索服务慢日志或应用调试日志中关联，才能知道是哪一个属性触发。
如果新增或修改商品属性后出现，检查该属性在 Magento 中是否用于搜索、分层导航、排序，以及不同文档是否产生冲突类型。索引映射一旦把字段确定为某种类型，后续写入另一种结构可能失败。
磁盘水位与只读索引会连锁出现
磁盘接近阈值时，分片可能无法分配，索引还可能被设为只读。查看节点磁盘和集群设置。释放空间时优先清理明确可删除的旧索引、日志或快照，不要直接删除当前线上别名指向的索引。
恢复可写后再重建搜索索引：
bin/magento indexer:reset catalogsearch_fulltext
bin/magento indexer:reindex catalogsearch_fulltext
bin/magento indexer:status catalogsearch_fulltext如果重建仍失败，继续处理第一条具体 bulk 或 mapping 错误。反复 reset 不会修复数据与集群问题。
搜索恢复后还要验证增量更新
全量重建成功只证明当前数据能写入。修改一个商品名称和一个可搜索属性，等待按计划索引后再次搜索，确认增量链路正常。还要测试分类页、价格排序、分层导航和自动建议，因为它们可能使用不同查询与聚合。
对高可用集群，补充节点、合理配置副本和监控未分配分片比故障后手工重建更重要。告警至少应覆盖 cluster status、磁盘水位、rejected requests、索引延迟和 Magento indexer 状态。
