CONFIGURATION PARAMETER连接和认证 / TCP 设置
tcp_user_timeout
设置 TCP 用户超时。
TCP user timeout.
整数 会话 引入 12 现存至 20 devel 0 次默认值变更
- 类型
- 整数integer
- 上下文
- 会话任何用户都可在会话内用 SET 修改
- 默认值
0 ms原始值 0 ms- 取值范围
0 – 2147483647- 引入版本
- 12
- 状态
- 现存
版本轨迹
相对 PostgreSQL 17 仅简述或分类有更新。
默认值变迁
默认值自 PostgreSQL 12 起没有变过。带单位的取值换算成了可读形式，原始的 boot_val 与单位写在悬浮提示里。
手册说明
本版译文与 PostgreSQL 14 完全一致，下面就是同一段文字。
指定已发送的数据在 TCP 连接被强制关闭之前最多可以保持未确认状态多长时间。 如果指定值时没有单位，则以毫秒为单位。值 0（默认值）表示选择操作系统默认值。 这个参数只在支持 TCP_USER_TIMEOUT 的系统上受支持（不包括 Windows）； 在其他系统上，它必须为零。在通过 Unix 域套接字连接的会话中，此参数会被忽略，并始终读作零。
机制详解
tcp_user_timeout：设置 TCP 用户超时。在操作系统支持时，它限制已发送数据保持未确认状态的时长；这不同于对空闲连接进行探测的 keepalive。
tcp_user_timeout 属于 USER 上下文。获授权角色可在会话内修改，ALTER ROLE 或 ALTER DATABASE 可为未来会话建立默认值。
多个超时会重叠，最先到期的适用期限获胜；客户端、连接池、TCP 与服务器取消行为决定工作被重试、取消还是关闭会话。
调优建议
按典型负载给出的取值思路，不是放之四海皆准的配方：实际取值要看数据量、并发度与硬件。
-
OLTP在线事务处理
按可接受的未确认数据停滞上限设置 tcp_user_timeout，使其短于服务故障转移预算，并测试客户端重试行为。
-
OLAP分析与批处理
为大结果传输的暂时拥塞留出空间，但应短于不可达对端占用工作进程直至作业窗口结束的时长。
-
小规格低配实例与开发机
除非实测半开连接需要边界，否则使用操作系统默认值；依赖前先确认平台支持。
常见问题
- 只在一个会话中修改 tcp_user_timeout，却认为角色默认值、数据库默认值或其他池化会话也已随之改变。
- 忘记零通常表示禁用超时或把行为交给操作系统。
- 设置重叠期限，却未明确哪个层负责重试、取消与连接丢弃。
- 把未确认数据超时与空闲套接字的 keepalive 探测混为一谈。
演化历史
相邻两个大版本之间的差异，新的在前。版本号链到该版的快照。
-
PostgreSQL 20 ← 19 沿用 19
事实沿用 19
-
PostgreSQL 18 ← 17 仅描述更新
补充说明
A value of 0 uses the system default.0 means use the system default. -
PostgreSQL 16 ← 15 仅描述更新
分类
Connections and Authentication / Connection SettingsConnections and Authentication / TCP Settings -
PostgreSQL 14 ← 13 仅描述更新
分类
Client Connection Defaults / Other DefaultsConnections and Authentication / Connection Settings -
PostgreSQL 12 ← 11 新增此参数
PostgreSQL 12 起可用
逐版本快照
每个收录版本里的 7 项事实，与上一个存在的版本不同的格子带底色。版本号链到该版。
| 版本 | 默认值 | 单位 | 上下文 | 类型 | 最小值 | 最大值 | 枚举值 |
|---|---|---|---|---|---|---|---|
| 12 | 0 ms |
ms |
会话 |
整数 |
0 |
2147483647 |
— |
| 13 | 0 ms |
ms |
会话 |
整数 |
0 |
2147483647 |
— |
| 14 | 0 ms |
ms |
会话 |
整数 |
0 |
2147483647 |
— |
| 15 | 0 ms |
ms |
会话 |
整数 |
0 |
2147483647 |
— |
| 16 | 0 ms |
ms |
会话 |
整数 |
0 |
2147483647 |
— |
| 17 | 0 ms |
ms |
会话 |
整数 |
0 |
2147483647 |
— |
| 18 | 0 ms |
ms |
会话 |
整数 |
0 |
2147483647 |
— |
| 19 | 0 ms |
ms |
会话 |
整数 |
0 |
2147483647 |
— |
| 20 沿用 | 0 ms |
ms |
会话 |
整数 |
0 |
2147483647 |
— |
参考资料
同类参数
| 参数 | 类型 | 上下文 | 默认值 | 版本变动 | 最近变更 |
|---|---|---|---|---|---|
| TCP 设置 5 | |||||
client_connection_check_interval |
整数 | 会话 | 0 ms |
— | |
| 设置查询运行期间检查客户端断连的时间间隔。 | 现存 | ||||
tcp_keepalives_count |
整数 | 会话 | 0 |
— | |
| 设置 TCP keepalive 的最大重传次数。 | 现存 | ||||
tcp_keepalives_idle |
整数 | 会话 | 0 s |
— | |
| 设置开始发送 TCP keepalive 前的空闲时间。 | 现存 | ||||
tcp_keepalives_interval |
整数 | 会话 | 0 s |
— | |
| 设置 TCP keepalive 重传之间的间隔。 | 现存 | ||||
tcp_user_timeout |
整数 | 会话 | 0 ms |
— | |
| 设置 TCP 用户超时。 | 现存 | ||||