---
title: "Transport Netty 接收缓冲区预测最大值配置"
date: 2026-03-27
lastmod: 2026-03-27
description: "transport.netty.receive_predictor_max 配置项用于定义 Netty 接收缓冲区分配器的最大预测值。"
tags: ["Transport", "Netty", "接收缓冲区", "性能优化"]
summary: "配置项作用 #  transport.netty.receive_predictor_max 配置项用于定义Netty 接收缓冲区分配器的最大预测值。
配置项属性 #   配置路径: transport.netty.receive_predictor_max 数据类型: ByteSizeValue（字节大小，支持 bytes、kb、mb、gb 单位） 默认值: 继承自 transport.netty.receive_predictor_size 的值（64KB） 是否可选: 是 作用域: NodeScope（节点级别） 动态更新: 否（需要重启节点生效）  配置建议 #  默认配置 #  transport: netty: receive_predictor_max: 64kb # 默认值 高吞吐场景 #  transport: netty: receive_predictor_max: 256kb 低延迟场景 #  transport: netty: receive_predictor_max: 32kb 注意事项 #    非动态更新: 需要重启节点生效。
  与 receive_predictor_min 配合使用:
 当 receive_predictor_max 等于 receive_predictor_min 时，使用固定大小的缓冲区分配器（FixedRecvByteBufAllocator） 当两者不相等时，使用自适应缓冲区分配器（AdaptiveRecvByteBufAllocator）    建议值: 通常保持与 receive_predictor_max 相同，使用固定大小；需要自适应缓冲区时，可以设置 min < max"
---


## 配置项作用

`transport.netty.receive_predictor_max` 配置项用于定义**Netty 接收缓冲区分配器的最大预测值**。

## 配置项属性

- **配置路径**: `transport.netty.receive_predictor_max`
- **数据类型**: `ByteSizeValue`（字节大小，支持 bytes、kb、mb、gb 单位）
- **默认值**: 继承自 `transport.netty.receive_predictor_size` 的值（64KB）
- **是否可选**: 是
- **作用域**: NodeScope（节点级别）
- **动态更新**: 否（需要重启节点生效）

## 配置建议

## 默认配置

```yaml
transport:
  netty:
    receive_predictor_max: 64kb  # 默认值
```

## 高吞吐场景

```yaml
transport:
  netty:
    receive_predictor_max: 256kb
```

## 低延迟场景

```yaml
transport:
  netty:
    receive_predictor_max: 32kb
```

## 注意事项

1. **非动态更新**: 需要重启节点生效。

2. **与 receive_predictor_min 配合使用**:
   - 当 `receive_predictor_max` 等于 `receive_predictor_min` 时，使用固定大小的缓冲区分配器（FixedRecvByteBufAllocator）
   - 当两者不相等时，使用自适应缓冲区分配器（AdaptiveRecvByteBufAllocator）

3. **建议值**: 通常保持与 `receive_predictor_max` 相同，使用固定大小；需要自适应缓冲区时，可以设置 min < max

4. **网络环境考虑**:
   - 高延迟网络：可适当增加到 128KB-256KB
   - 低延迟网络：可适当降低到 32KB