---
title: "Transport TCP 连接超时配置"
date: 2026-03-06
lastmod: 2026-03-06
description: "transport.tcp.connect_timeout 配置项用于控制 TCP 连接建立的超时时间。"
tags: ["Transport", "TCP", "超时配置"]
summary: "配置项作用 #  transport.tcp.connect_timeout 配置项用于控制TCP 连接建立的超时时间。
配置项属性 #   配置路径: transport.tcp.connect_timeout 数据类型: TimeValue（时间值） 默认值: 30s（30 秒） 是否可选: 是 作用域: NodeScope（节点级别） 动态更新: 否（需要重启节点生效） 废弃状态: 已废弃，建议使用 transport.connect_timeout  配置建议 #  默认配置 #  transport: tcp: connect_timeout: 30s  # 默认值 高延迟网络 #  transport: tcp: connect_timeout: 60s 相关配置 #     配置项 作用 默认值     tcp.connect_timeout 连接超时 30s   tcp.keep_alive 保活开关 true    注意事项 #    已废弃: 建议使用 transport."
---


## 配置项作用

`transport.tcp.connect_timeout` 配置项用于控制**TCP 连接建立的超时时间**。

## 配置项属性

- **配置路径**: `transport.tcp.connect_timeout`
- **数据类型**: `TimeValue`（时间值）
- **默认值**: `30s`（30 秒）
- **是否可选**: 是
- **作用域**: NodeScope（节点级别）
- **动态更新**: 否（需要重启节点生效）
- **废弃状态**: 已废弃，建议使用 `transport.connect_timeout`

## 配置建议

## 默认配置

```yaml
transport:
  tcp:
    connect_timeout: 30s  # 默认值
```

## 高延迟网络

```yaml
transport:
  tcp:
    connect_timeout: 60s
```

## 相关配置

| 配置项 | 作用 | 默认值 |
|--------|------|--------|
| `tcp.connect_timeout` | 连接超时 | 30s |
| `tcp.keep_alive` | 保活开关 | true |

## 注意事项

1. **已废弃**: 建议使用 `transport.connect_timeout`。

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

3. **网络延迟**: 根据网络延迟调整。