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–19 之间未变。带单位的取值换算成了可读形式，原始的 boot_val 与单位写在悬浮提示里。
手册说明
指定已发送的数据在 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 18 ← 17 仅描述更新
补充说明
A value of 0 uses the system default.0 means use the system default. -
PostgreSQL 12 ← 11 新增此参数
PostgreSQL 12 起可用
逐版本快照
每个收录版本里的 7 项事实，与上一个存在的版本不同的格子带底色。版本号链到该版。
参考资料
同类参数
| 参数 | 类型 | 上下文 | 默认值 | 版本变动 | 最近变更 |
|---|---|---|---|---|---|
| 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 连接被强制关闭之前最多可以保持未确认状态多长时间。 | 现存 | ||||