---
title: "Transport Netty 接收缓冲区预测大小配置"
date: 2026-01-26
lastmod: 2026-01-26
description: "transport.netty.receive_predictor_size 配置项用于定义 Netty 接收缓冲区大小预测的基础值。"
tags: ["Transport", "Netty", "接收缓冲区", "性能优化"]
summary: "配置项作用 #  transport.netty.receive_predictor_size 配置项用于定义Netty 接收缓冲区大小预测的基础值。
配置项属性 #   配置路径: transport.netty.receive_predictor_size 数据类型: ByteSizeValue（字节大小，支持 bytes、kb、mb、gb 单位） 默认值: 64kb 是否可选: 是 作用域: NodeScope（节点级别） 动态更新: 否（需要重启节点生效）  配置建议 #  默认配置 #  transport: netty: receive_predictor_size: 64kb  # 默认值 大文件传输或高吞吐场景 #  transport: netty: receive_predictor_size: 128kb 低延迟场景 #  transport: netty: receive_predictor_size: 32kb 注意事项 #    非动态更新: 需要重启节点生效。
  基础配置值: 这是 receive_predictor 配置的基础值，同时也是 receive_predictor_min 和 receive_predictor_max 的默认值。
  性能影响: 控制了 Netty 传输层的接收缓冲区大小预测机制，优化网络 I/O 性能，减少内存分配和复制的开销。"
---


## 配置项作用

`transport.netty.receive_predictor_size` 配置项用于定义**Netty 接收缓冲区大小预测的基础值**。

## 配置项属性

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

## 配置建议

## 默认配置

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

## 大文件传输或高吞吐场景

```yaml
transport:
  netty:
    receive_predictor_size: 128kb
```

## 低延迟场景

```yaml
transport:
  netty:
    receive_predictor_size: 32kb
```

## 注意事项

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

2. **基础配置值**: 这是 receive_predictor 配置的基础值，同时也是 `receive_predictor_min` 和 `receive_predictor_max` 的默认值。

3. **性能影响**: 控制了 Netty 传输层的接收缓冲区大小预测机制，优化网络 I/O 性能，减少内存分配和复制的开销。

4. **选择建议**:
   - 默认值 64KB 适用于大多数场景
   - 大文件传输或高吞吐量场景：可增加到 128KB-256KB
   - 低延迟场景：可降低到 32KB
   - 设置时要考虑网络条件和机器内存