---
title: "跨集群复制跟随者保留租约最大失败持续时间配置"
date: 2026-02-27
lastmod: 2026-02-27
description: "replication.follower.retention_lease_max_failure_duration 配置项用于定义跟随者在取消保留租约前可以失败的最长持续时间。"
tags: ["跨集群复制", "CCR", "跟随者", "租约管理"]
summary: "配置项作用 #  replication.follower.retention_lease_max_failure_duration 配置项用于定义跟随者在取消保留租约前可以与领导者失败通信的最长持续时间。
配置项属性 #   配置路径: replication.follower.retention_lease_max_failure_duration 数据类型: TimeValue（时间值） 默认值: 1h（1小时） 是否可选: 是 作用域: NodeScope（节点级别） 动态更新: 是（可以动态更新，无需重启）  配置建议 #  默认配置 #  replication: follower: retention_lease_max_failure_duration: 1h  # 默认值 稳定网络环境 #  replication: follower: retention_lease_max_failure_duration: 4h  # 延长容忍时间 快速故障转移 #  replication: follower: retention_lease_max_failure_duration: 30m  # 更快触发故障转移 功能说明 #  租约机制 #  如果跟随者在此时间内无法与领导者通信，其保留租约将被取消。
失败处理 #   较长的持续时间: 允许更长的故障恢复时间 较短的持续时间: 更快释放资源并触发故障转移  使用场景 #  高可用性要求 #  # 需要快速故障转移 replication: follower: retention_lease_max_failure_duration: 30m 网络不稳定环境 #  # 容忍较长的网络中断 replication: follower: retention_lease_max_failure_duration: 2h 注意事项 #    动态更新: 此配置可以动态更新，无需重启节点。"
---


## 配置项作用

`replication.follower.retention_lease_max_failure_duration` 配置项用于**定义跟随者在取消保留租约前可以与领导者失败通信的最长持续时间**。

## 配置项属性

- **配置路径**: `replication.follower.retention_lease_max_failure_duration`
- **数据类型**: `TimeValue`（时间值）
- **默认值**: `1h`（1小时）
- **是否可选**: 是
- **作用域**: NodeScope（节点级别）
- **动态更新**: 是（可以动态更新，无需重启）

## 配置建议

## 默认配置

```yaml
replication:
  follower:
    retention_lease_max_failure_duration: 1h  # 默认值
```

## 稳定网络环境

```yaml
replication:
  follower:
    retention_lease_max_failure_duration: 4h  # 延长容忍时间
```

## 快速故障转移

```yaml
replication:
  follower:
    retention_lease_max_failure_duration: 30m  # 更快触发故障转移
```

## 功能说明

## 租约机制

如果跟随者在此时间内无法与领导者通信，其保留租约将被取消。

## 失败处理

- **较长的持续时间**: 允许更长的故障恢复时间
- **较短的持续时间**: 更快释放资源并触发故障转移

## 使用场景

## 高可用性要求

```yaml
# 需要快速故障转移
replication:
  follower:
    retention_lease_max_failure_duration: 30m
```

## 网络不稳定环境

```yaml
# 容忍较长的网络中断
replication:
  follower:
    retention_lease_max_failure_duration: 2h
```

## 注意事项

1. **动态更新**: 此配置可以动态更新，无需重启节点。

2. **默认合理**: 默认值 1 小时对大多数环境是合理的。

3. **故障转移**: 较短的时间可以更快触发故障转移。

4. **网络稳定性**: 根据网络稳定性调整此值。