---
title: "集群恢复时间延迟配置"
date: 2026-01-16
lastmod: 2026-01-16
description: "控制集群状态恢复延迟的配置说明"
tags: ["Gateway", "集群恢复", "启动配置"]
summary: "配置项作用 #  gateway.recover_after_time 配置项控制集群状态恢复前的延迟时间。当必要的节点可用后，系统会等待指定的时间间隔后才开始恢复集群状态。
是否可选 #  是
默认值 #  0ms (无延迟) 配置项类型 #  静态配置 - 需要重启节点才能生效
配置格式 #  # 默认配置（无延迟） gateway.recover_after_time: 0ms # 设置延迟 gateway.recover_after_time: 1m # 更长延迟 gateway.recover_after_time: 5m # 使用秒 gateway.recover_after_time: 30s 工作原理 #  ┌─────────────────────────────────────────────────────────┐ │ 集群恢复流程 │ └─────────────────────────────────────────────────────────┘ 节点启动 │ ▼ 检查必要节点 │ ├── 节点未就绪 → 等待 │ └── 节点就绪 │ ▼ 等待 recover_after_time │ ├── 时间到 → 开始恢复 │ └── 等待中."
---


## 配置项作用

`gateway.recover_after_time` 配置项控制集群状态恢复前的延迟时间。当必要的节点可用后，系统会等待指定的时间间隔后才开始恢复集群状态。

## 是否可选

是

## 默认值

```
0ms (无延迟)
```

## 配置项类型

**静态配置** - 需要重启节点才能生效

## 配置格式

```yaml
# 默认配置（无延迟）
gateway.recover_after_time: 0ms

# 设置延迟
gateway.recover_after_time: 1m

# 更长延迟
gateway.recover_after_time: 5m

# 使用秒
gateway.recover_after_time: 30s
```

## 工作原理

```
┌─────────────────────────────────────────────────────────┐
│                   集群恢复流程                            │
└─────────────────────────────────────────────────────────┘

节点启动
    │
    ▼
检查必要节点
    │
    ├── 节点未就绪 → 等待
    │
    └── 节点就绪
        │
        ▼
    等待 recover_after_time
        │
        ├── 时间到 → 开始恢复
        │
        └── 等待中...
```

## 推荐设置

| 环境 | 推荐值 | 说明 |
|------|--------|------|
| 默认配置 | 0ms | 立即恢复 |
| 大型集群 | 1-5m | 给节点时间加入 |
| 不稳定网络 | 5-10m | 确保节点稳定 |
| 滚动重启 | 5m | 防止数据丢失 |

## 使用示例

**立即恢复：**

```yaml
gateway.recover_after_time: 0ms
```

**延迟恢复：**

```yaml
gateway.recover_after_time: 1m
```

## 配置验证

```bash
# 查看当前配置
GET /_cluster/settings?filter_path=*.gateway.recover_after_time

# 查看集群状态
GET /_cluster/health
```

## 注意事项

1. **静态配置**：修改需要重启节点
2. **恢复延迟**：会增加集群不可用时间
3. **稳定性**：延迟恢复可以提高稳定性
4. **配合使用**：可与其他 gateway 配置配合使用

## 相关配置项

| 配置项 | 默认值 | 说明 |
|-------|-------|------|
| `gateway.expected_data_nodes` | -1 | 期望数据节点数 |
| `gateway.recover_after_data_nodes` | -1 | 恢复所需数据节点数 |