讲师中心 微信公众号

工具推荐

视频效率加速
Seko
Seko

AI短剧一键生成成片

SoundView
SoundView

字幕擦除翻译、配音口型同步

Laper
Laper

剧本策划到成片协作

AniShort
AniShort

AI短剧协同制作平台

Nginx针对高并发API场景调优长连接超时参数

小晨同学_3909

小晨同学_3909

发布时间:2026-03-19 10:29:47

|

650人浏览过

|

来源于php中文网

原创

Nginx长连接调优需协同配置keepalive_timeout、keepalive_requests及upstream keepalive参数:前者控制空闲连接关闭时机(建议30–300s,略小于客户端值),后者限制单连接请求数(默认100,可调至50–5000),upstream需启用keepalive并匹配后端超时与连接数限制,调优后须通过stub_status、ss命令及抓包验证复用效果。

nginx针对高并发api场景调优长连接超时参数

在高并发API场景下,Nginx的长连接(Keepalive)超时参数直接影响连接复用率、资源占用和响应延迟。调优核心是平衡连接复用收益与空闲连接堆积风险,避免因超时设置不合理导致TIME_WAIT激增、端口耗尽或客户端502/504错误。

keepalive_timeout:控制服务端主动关闭空闲连接的时机

该参数定义Nginx保持客户端长连接的最大空闲时间,单位秒。默认值通常为65s,但在高并发API场景中常需调整:

  • 若上游API响应快、客户端连接频繁复用(如移动端App、前端SPA),可适当延长至120–300s,提升复用率,降低TCP握手开销;
  • 若后端处理延迟波动大、或客户端存在“假长连接”(如弱网下未及时发请求但连接未断),建议缩短至30–60s,避免大量空闲连接占满worker_connections;
  • 注意:该值应略小于客户端(如浏览器、OkHttp、axios)的keep-alive timeout,否则Nginx会先断连,导致客户端误判为异常中断。

keepalive_requests:限制单连接最大请求数

防止单个长连接持续占用资源过久,尤其适用于请求体大、或存在内存泄漏风险的旧版上游服务:

  • 默认100,对纯JSON API通常足够;若接口轻量且稳定,可调高至1000甚至5000,减少连接重建频率;
  • 若发现Nginx日志中频繁出现"client closed connection while waiting for request"或上游偶发超时,可尝试降低至50–200,强制连接轮转,缓解潜在连接老化问题;
  • 该值不触发TCP断开,仅在达到后标记连接为“可关闭”,实际断开仍受keepalive_timeout约束。

upstream keepalive相关参数:复用到后端的连接池

仅配置客户端侧不够,还需开启并调优到上游服务(如Go/Java微服务)的长连接池:

  • upstream中启用keepalive:keepalive 32;(表示每个worker进程最多缓存32个空闲到上游的连接);
  • 配合proxy_http_version 1.1和Connection头:proxy_http_version 1.1; proxy_set_header Connection '';,确保不透传Connection: close;
  • keepalive_timeout也作用于上游:可在upstream块内单独设keepalive_timeout 60s;,建议与后端服务的keepalive设置一致,避免单方面断连;
  • 注意:keepalive数量不宜超过后端单实例能承载的并发连接数,否则可能引发后端连接拒绝(如Tomcat maxConnections超限)。

配套检查与验证要点

调优后需结合指标确认效果,而非仅看配置生效:

  • 监控nginx_stub_status中的Active connections与Reading/Writing/Waiting比例,Waiting长期偏高可能说明keepalive_timeout过长或后端响应慢;
  • 用ss -ant | grep :80 | wc -l观察ESTABLISHED连接数趋势,对比调优前后是否显著下降(说明复用率提升)或突增(可能timeout太短导致重连风暴);
  • 抓包验证:客户端发起两次请求,检查第二请求是否复用同一TCP流(源端口不变),且无SYN/SYN-ACK往返;
  • 检查error.log中是否有"upstream prematurely closed connection",常因upstream keepalive_timeout

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

热门AI工具

更多
WorkBuddy

一款AI办公效率工具,主要用于腾讯云推出的AI原生桌面智能体工作台,适合需要提升相关任务效率的用户。

小橡皮AI

一款AI工具,主要用于小橡皮一键去AI味,将机器味重的内容改得更有活人感,防止因为 AI 内容被平台打上 AI 标签,以及限流,适合需要提升相关任务效率的用户。

PixPix
PixPix Hot

PixPix是一款面向电商视觉生产的AI商品图生成工具。

DeepSeek

DeepSeek是一款面向对话、写作、编程和推理场景的AI大模型工具。

VibeKnow
VibeKnow Hot

一款AI视频创作工具,主要用于全球首个AI知识视频创作平台,文档、文章、网页,一键生成视频,适合需要提升相关任务效率的用户。

UpDream
UpDream Hot

一款AI视频创作工具,主要用于哔哩哔哩推出的自研AI视频创作工具,适合需要提升相关任务效率的用户。

讯飞智文

一款面向学习和办公场景的AI文档创作工具,可辅助生成PPT与Word文档,提高资料整理和内容制作效率。

豆包大模型

豆包大模型是一款由字节跳动推出的企业级大语言模型服务平台。

Seko
Seko Hot

一款AI视频创作工具,主要用于商汤科技推出的创编一体的AI短视频创作Agent,适合需要提升相关任务效率的用户。

相关专题

更多
nginx 重启
nginx 重启

nginx重启对于网站的运维来说是非常重要的,根据不同的需求,可以选择简单重启、平滑重启或定时重启等方式。本专题为大家提供nginx重启的相关的文章、下载、课程内容,供大家免费下载体验。

423

2023.07.27

nginx 配置详解
nginx 配置详解

Nginx的配置是指设置和调整Nginx服务器的行为和功能的过程。通过配置文件,可以定义虚拟主机、HTTP请求处理、反向代理、缓存和负载均衡等功能。Nginx的配置语法简洁而强大,允许管理员根据自己的需要进行灵活的调整。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

4347

2023.08.04

nginx配置详解
nginx配置详解

NGINX与其他服务类似,因为它具有以特定格式编写的基于文本的配置文件。本专题为大家提供nginx配置相关的文章,大家可以免费学习。

7265

2023.08.04

tomcat和nginx有哪些区别
tomcat和nginx有哪些区别

tomcat和nginx的区别:1、应用领域;2、性能;3、功能;4、配置;5、安全性;6、扩展性;7、部署复杂性;8、社区支持;9、成本;10、日志管理。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

601

2024.02.23

nginx报404怎么解决
nginx报404怎么解决

当访问 nginx 网页服务器时遇到 404 错误,表明服务器无法找到请求资源,可以通过以下步骤解决:1. 检查文件是否存在且路径正确;2. 检查文件权限并更改为 644 或 755;3. 检查 nginx 配置,确保根目录设置正确、没有冲突配置等等。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

1516

2024.07.09

Nginx报404错误解决方法
Nginx报404错误解决方法

解决方法:只需要加上这段配置:try_files $uri $uri/ /index.html;即可。想了解更多Nginx的相关内容,可以阅读本专题下面的文章。

3998

2024.08.07

nginx部署php项目教程汇总
nginx部署php项目教程汇总

本专题整合了nginx部署php项目教程汇总,阅读专题下面的文章了解更多详细内容。

122

2026.01.13

nginx配置文件详细教程
nginx配置文件详细教程

本专题整合了nginx配置文件相关教程详细汇总,阅读专题下面的文章了解更多详细内容。

617

2026.01.13

GoFrame框架Web开发与路由中间件
GoFrame框架Web开发与路由中间件

本专题聚焦GoFrame框架的Web开发,拆解路由注册与匹配规则、请求参数获取、参数校验与中间件执行顺序,说明统一响应、JWT鉴权、文件上传与接口文档生成的落地方式,并补充优雅重启与测试实践。

0

2026.11.17

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
热门推荐
/
最新课程
关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn