---
title: "分片状态重路由优先级配置"
date: 2026-03-24
lastmod: 2026-03-24
description: "控制分片状态变化后重路由任务优先级的配置项说明"
tags: ["集群配置", "分片管理", "任务调度"]
summary: "配置项作用 #  cluster.routing.allocation.shard_state.reroute.priority 配置项控制分片状态变化（如分片启动、失败）后，后续重路由（reroute）任务的优先级。此配置用于调整集群在处理分片状态变化后重新分配分片的紧急程度。
 注意：此配置已标记为已弃用，是专家级的最后手段配置项，不推荐普通用户修改。
 配置项类型 #  该配置项为动态配置，可以在运行时通过集群设置 API 进行修改。
默认值 #  NORMAL 是否必需 #  可选配置项（有默认值）
取值范围 #  NORMAL（默认） HIGH URGENT 配置格式 #  # 默认配置 cluster.routing.allocation.shard_state.reroute.priority: NORMAL # 提高优先级 cluster.routing.allocation.shard_state.reroute.priority: HIGH # 最高优先级 cluster.routing.allocation.shard_state.reroute.priority: URGENT 相关配置项 #     配置项 默认值 说明     cluster.routing.allocation.shard_state.reroute.priority NORMAL 重路由任务优先级   cluster.routing.allocation.enable all 分片分配开关    工作原理 #  重路由任务优先级机制："
---


## 配置项作用

`cluster.routing.allocation.shard_state.reroute.priority` 配置项控制分片状态变化（如分片启动、失败）后，后续重路由（reroute）任务的优先级。此配置用于调整集群在处理分片状态变化后重新分配分片的紧急程度。

> **注意**：此配置已标记为**已弃用**，是专家级的最后手段配置项，不推荐普通用户修改。

## 配置项类型

该配置项为**动态配置**，可以在运行时通过集群设置 API 进行修改。

## 默认值

```
NORMAL
```

## 是否必需

**可选配置项**（有默认值）

## 取值范围

```
NORMAL（默认）
HIGH
URGENT
```

## 配置格式

```yaml
# 默认配置
cluster.routing.allocation.shard_state.reroute.priority: NORMAL

# 提高优先级
cluster.routing.allocation.shard_state.reroute.priority: HIGH

# 最高优先级
cluster.routing.allocation.shard_state.reroute.priority: URGENT
```

## 相关配置项

| 配置项 | 默认值 | 说明 |
|-------|-------|------|
| `cluster.routing.allocation.shard_state.reroute.priority` | NORMAL | 重路由任务优先级 |
| `cluster.routing.allocation.enable` | all | 分片分配开关 |

## 工作原理

重路由任务优先级机制：

```
┌─────────────────────────────────────────────────────────────────┐
│                    分片状态变化处理流程                           │
└─────────────────────────────────────────────────────────────────┘

分片状态变化
    │
    ├── 分片启动（Shard Started）
    └── 分片失败（Shard Failed）
        │
        ▼
提交集群状态更新任务
    │
    ├── 队列中按优先级排序
    │   ├── URGENT（最高优先级）
    │   ├── HIGH
    │   └── NORMAL（默认）
    │
    ▼
执行状态更新
    │
    ▼
创建后续重路由任务
    │
    └── 使用 shard_state.reroute.priority 作为优先级
        │
        ▼
重新分配未分配分片
```

## 优先级说明

```
URGENT（紧急）:
    - 最高的任务优先级
    - 立即执行，不等待其他任务
    - 用于关键操作
    - 可能影响其他重要任务

HIGH（高）:
    - 高优先级
    - 在 NORMAL 之前执行
    - 用于重要操作
    - 平衡响应速度

NORMAL（普通）:
    - 默认优先级
    - 按队列顺序执行
    - 适合大多数场景
    - 保持系统稳定
```

## 使用场景

### 1. 默认配置（推荐）

```yaml
cluster.routing.allocation.shard_state.reroute.priority: NORMAL
```

**适用场景：**
- 所有标准集群配置
- 不需要特殊优先级调整
- 保持系统稳定性

### 2. 提高响应速度

```yaml
cluster.routing.allocation.shard_state.reroute.priority: HIGH
```

**适用场景：**
- 需要快速恢复未分配分片
- 集群配置不当导致频繁重路由
- 临时提高响应速度

### 3. 最高优先级（不推荐）

```yaml
cluster.routing.allocation.shard_state.reroute.priority: URGENT
```

**适用场景：**
- 专家诊断
- 紧急恢复操作
- 仅在特定情况下使用

## 推荐设置建议

| 场景 | 推荐值 | 说明 |
|-----|-------|------|
| 所有场景 | NORMAL | 默认配置，推荐 |
| 快速恢复 | HIGH | 临时使用 |
| 专家调试 | URGENT | 谨慎使用 |

## 为什么默认使用 NORMAL

```
NORMAL 优先级的原因:

1. 避免任务优先级反转
   - 防止重路由任务阻塞其他重要任务

2. 平衡系统负载
   - 给集群状态更新任务完成时间
   - 避免过于激进的重分配

3. 批量处理效率
   - 允许多个分片状态变化批量处理
   - 减少不必要的重路由次数

4. 系统稳定性
   - 避免频繁的集群状态更新
   - 减少主节点压力
```

## 何时需要调整优先级

```
可能需要提高优先级的情况:

1. 大量未分配分片
   - 分片长期未分配
   - 需要快速恢复

2. 集群配置问题
   - 节点资源不足
   - 分配规则过于严格

3. 临时恢复操作
   - 节点故障后恢复
   - 需要快速重新平衡

注意：提高优先级只是临时措施
应该解决根本问题而不是依赖此配置
```

## 动态配置示例

```bash
# 临时提高优先级
PUT /_cluster/settings
{
  "transient": {
    "cluster.routing.allocation.shard_state.reroute.priority": "HIGH"
  }
}

# 恢复默认
PUT /_cluster/settings
{
  "transient": {
    "cluster.routing.allocation.shard_state.reroute.priority": null
  }
}
```

## 监控建议

```bash
# 查看当前配置
GET /_cluster/settings?filter_path=*.cluster.routing.allocation.shard_state.reroute.priority

# 查看未分配分片
GET /_cat/shards?v&h=index,shard,prirep,state,node | grep UNASSIGNED

# 查看重路由原因
GET /_cluster/allocation/explain?verbose
```

## 注意事项

1. **已弃用**：此配置已标记为已弃用，未来可能移除
2. **专家使用**：仅建议专家用户在特定情况下修改
3. **临时措施**：提高优先级应作为临时措施
4. **解决根本问题**：应解决导致未分配分片的根本原因
5. **系统影响**：过高优先级可能影响其他集群操作
6. **默认推荐**：绝大多数情况下应使用默认的 NORMAL