---
title: "Transport TCP No Delay 配置"
date: 2026-01-07
lastmod: 2026-01-07
description: "transport.tcp_no_delay 配置项用于控制是否禁用 Nagle 算法。"
tags: ["Transport", "TCP", "No Delay", "延迟优化"]
summary: "配置项作用 #  transport.tcp_no_delay 配置项用于控制是否禁用 Nagle 算法（启用 TCP_NODELAY 选项）。
配置项属性 #   配置路径: transport.tcp_no_delay 数据类型: Boolean（布尔值） 默认值: true 是否可选: 是 作用域: NodeScope（节点级别） 动态更新: 否（需要重启节点生效） 废弃状态: 已废弃，建议使用 transport.tcp.no_delay  配置建议 #  默认配置 #  transport: tcp_no_delay: true # 默认值，推荐使用 推荐配置（新写法） #  transport: tcp: no_delay: true # 推荐使用点号分隔的写法 高吞吐场景（不推荐禁用） #  transport: tcp: no_delay: false # 启用 Nagle 算法，合并小包 注意事项 #    已废弃: 建议使用 transport.tcp.no_delay（点号分隔）代替 transport.tcp_no_delay（下划线分隔）。
  非动态更新: 需要重启节点生效。"
---


## 配置项作用

`transport.tcp_no_delay` 配置项用于控制**是否禁用 Nagle 算法**（启用 TCP_NODELAY 选项）。

## 配置项属性

- **配置路径**: `transport.tcp_no_delay`
- **数据类型**: `Boolean`（布尔值）
- **默认值**: `true`
- **是否可选**: 是
- **作用域**: NodeScope（节点级别）
- **动态更新**: 否（需要重启节点生效）
- **废弃状态**: 已废弃，建议使用 `transport.tcp.no_delay`

## 配置建议

## 默认配置

```yaml
transport:
  tcp_no_delay: true  # 默认值，推荐使用
```

## 推荐配置（新写法）

```yaml
transport:
  tcp:
    no_delay: true  # 推荐使用点号分隔的写法
```

## 高吞吐场景（不推荐禁用）

```yaml
transport:
  tcp:
    no_delay: false  # 启用 Nagle 算法，合并小包
```

## 注意事项

1. **已废弃**: 建议使用 `transport.tcp.no_delay`（点号分隔）代替 `transport.tcp_no_delay`（下划线分隔）。

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

3. **Nagle 算法**:
   - 启用（no_delay=false）：小包会等待合并成大包发送，减少网络开销但增加延迟
   - 禁用（no_delay=true）：小包立即发送，减少延迟但可能增加网络开销

4. **推荐设置**:
   - 大多数场景应设置为 `true`（默认值），特别是对延迟敏感的操作
   - 仅在发送大量小包且希望优化网络带宽而非延迟时设置为 `false`

5. **作用**: 控制传输层连接上的 TCP_NODELAY 选项，影响集群节点间通信的延迟特性。