http2_idle_timeout用于控制http/2连接空闲超时，须在启用http2的listen指令所在server块中配置，默认180s，仅作用于无帧传输期，不替代keepalive_timeout等其他超时指令。
在 Nginx 中，http2_idle_timeout 用于控制 HTTP/2 连接在无活动时的最长保持时间。它不是全局指令，而是仅在 http2 指令启用的前提下，作用于 http、server 或 location 块中的 listen 配置上——也就是说，它必须配合 http2 参数使用，否则无效。
确认 HTTP/2 已启用并支持该指令
Nginx 1.9.5+ 支持 HTTP/2，但需满足两个前提：
- 编译时启用了
--with-http_v2_module - SSL/TLS 终止由 Nginx 承担（HTTP/2 在 TLS 上运行，不支持明文 h2c）
典型监听配置示例如下：
listen 443 ssl http2;只有在此类带 http2 的 listen 行所在作用域中，http2_idle_timeout 才生效。
正确设置 http2_idle_timeout 的位置和值
该指令不能写在 http 块顶层（除非嵌套在具体 server 内），推荐放在 server 块中，紧邻 listen 指令之后：
listen 443 ssl http2;
http2_idle_timeout 180s;
# 其他配置...
}
默认值为 3m（即 180 秒），可设为 0 表示禁用空闲超时（不推荐，易导致连接堆积）；常见合理范围是 60s～300s，取决于客户端行为与后端稳定性。
注意与其他超时指令的协同关系
http2_idle_timeout 仅管理“无帧传输”的空闲期，不替代以下关键超时：
-
keepalive_timeout：控制 HTTP/1.1 连接复用时长，对 HTTP/2 无影响 -
client_header_timeout和client_body_timeout：限制请求头/体接收阶段的等待时间 -
send_timeout：限制响应发送过程中的两次写操作间隔
若客户端长时间未发新请求但连接未关闭，优先由 http2_idle_timeout 触发断连；若在接收请求头时卡住，则由 client_header_timeout 干预。
验证配置是否生效
修改后执行 nginx -t 确保语法正确，再 nginx -s reload。可通过以下方式确认：
- 用
curl -I --http2 https://your-domain/检查响应头是否含HTTP/2 200 - 抓包观察 TCP 连接在无数据交互后是否按设定时间关闭（如 Wireshark 过滤
http2+tcp.fin） - 查看 Nginx error 日志，搜索
"client timed out"或"http2 idle timeout"相关记录
