---
title: "搜索归约阶段异常 (reduce_search_phase_exception) 错误排查与解决"
date: 2026-01-28
lastmod: 2026-01-28
description: "reduce_search_phase_exception 表示搜索的归约阶段失败，该阶段合并来自多个分片的结果，需要检查分片状态和简化聚合。"
tags: ["搜索", "聚合", "归约"]
summary: "为什么这个错误发生 #  reduce_search_phase_exception 表示搜索的归约阶段失败，该阶段合并来自多个分片的结果。
如何修复 #  1. 检查分片状态 #  GET /_cat/shards?v 2. 简化聚合 #  减少聚合复杂度。
3. 增加超时时间 #  GET /<index>/_search?timeout=30s 预防措施 #   优化聚合查询 监控分片健康  "
---


## 为什么这个错误发生

`reduce_search_phase_exception` 表示搜索的归约阶段失败，该阶段合并来自多个分片的结果。

## 如何修复

### 1. 检查分片状态
```bash
GET /_cat/shards?v
```

### 2. 简化聚合
减少聚合复杂度。

### 3. 增加超时时间
```bash
GET /<index>/_search?timeout=30s
```

### 预防措施
- 优化聚合查询
- 监控分片健康