nginx报错499是什么原因?先查访问日志再查上游超时
- 2026年11月19日
- 32 次
遇到nginx报错499,我现在只做两件事:把 access.log 里那条请求的耗时字段抄出来,再去跟上游的响应时间对一遍。原因多半不在 nginx,是客户端等不下去先关了连接,后端还在算。
这个判断有前提。nginx 前面得有一层会主动超时的东西——浏览器、App 的 okhttp,或者自己写的 axios,常见的值是三十秒。前面没人管超时,499 就多半来自用户关页面,或者中间那台负载均衡先断,方向要换。
499 那一行到底是谁写的
499 不在 HTTP 标准里,它是 nginx 自己定义的状态码,意思是客户端在服务端给出响应之前就关掉了连接。这个码由代理层写进访问日志,上游的 PHP 看不到它。

所以成因里没有「上游返回了 499」这一项。真正发生的事是:nginx 把请求转给 php-fpm,再往后是后端接口,它还在等对方回话,客户端那边的 TCP 已经发了 FIN;nginx 察觉连接断了,记一笔 499,再把上游连接也关掉。
客户端为什么先走?最常见就是等太久,自己那边的超时到了。接下来要回答的是「等了多久、等在哪一段」,不是「nginx 出了什么毛病」。
图里这条链路是排查的底图。客户端、nginx、php-fpm、后端接口四段串起来,499 只可能落在 nginx 写日志的那一刻,前面的环节都不产出这个码。
access.log里的499是什么样
combined 格式里没有耗时字段,能直接看的只有状态码。要判断就得先改 log_format,把四个时间和上游状态码挂上去——这一段只能写在 http{} 里,改完先 nginx -t 再 reload。
log_format timing '$remote_addr [$time_local] "$request" $status '
'rt=$request_time urt=$upstream_response_time '
'uct=$upstream_connect_time uht=$upstream_header_time '
'us=$upstream_status';
access_log /var/log/nginx/access.log timing;
之后每行尾部会多出五个键值。默认 combined 里状态码后面跟的是响应体字节数,这份格式没保留那一列,所以 499 的行尾部只剩 rt= 起的五个键。响应一个字节都没发出去时,us 就是横杠。查的时候不必翻整行,把时间字段截出来就行,下面这条只留尾部。
grep ' 499 ' /var/log/nginx/access.log | tail -n 2 \
| sed 's/.*rt=/rt=/'
跑完应该看到两行纯时间字段,形如 rt=30.001 urt=- uct=0.000 uht=- us=-,以及 rt=30.004 urt=30.002 uct=0.002 uht=29.998 us=200。
第一行的 urt 是个横杠,意思是到客户端断开那一刻,上游一个字节都没回。第二行上游在第 30.002 秒把响应给全了,客户端在 30.004 秒挂断,差的那 2 毫秒是 nginx 往 socket 写响应的时间——这种行说明上游没超时,是客户端自己到点了。
两行摆在一起,问题就换了形状:不是 nginx 出了毛病,是有请求在这条链路上跑到了三十秒。
上游耗时该看哪一列
三个 upstream 时间有先后。$upstream_connect_time 是和上游建连的耗时,$upstream_header_time 是从发出请求到收到响应头,$upstream_response_time 是到响应体收完。大小关系是 connect ≤ header ≤ response。
对着这条记录,urt 有值时先做减法:拿 $request_time 减 $upstream_response_time。差值接近 0,时间全花在等上游;差值明显,多出来的部分花在 nginx 自己身上——写响应、gzip、sendfile,或者客户端读得太慢。urt 是横杠时减法做不了,改看 $request_time 是不是正好等于前端那个 timeout,对得上就是客户端到点先撤。
分段看更直接。uct 大而 uht 小,卡在建连,多半是 php-fpm 的 listen backlog 满了,或者进程被占满;uct 正常但 uht 几乎等于 urt,那是 PHP 算得久,跟网络无关。

一行日志只回答一个问题:时间停在哪一段。
上游超时和499的先后
这条链路上有三个超时能掐断请求,谁先到,日志就长成谁的样子。
客户端超时最先到,记 499,urt 常常是空的,因为上游还没答完。nginx 的 fastcgi_read_timeout 或 proxy_read_timeout 先到,记 504:响应头已经收到、卡在读 body 时,urt 有值、us 可能已是 200;连响应头都没等到时,urt 还是横杠、us 是 0。php-fpm 的 request_terminate_timeout 先到,进程被杀,nginx 记 502。
「先后」的意义就在这:同一个三十秒,499 和 504 描述的是两种失败。一个是人不等了,一个是 nginx 不等了。落到日志里,nginx报错499的 rt 贴着前端 timeout,504 的 rt 贴着 nginx 自己的 read_timeout。

拿不准时把 $request_time 和前端那个 timeout 对一下。请求耗时刚好等于前端的 timeout,30.001 对上 30 秒,基本能定案:客户端到点撤了,nginx 只是记账的那个。
php-fpm 那边的时间去哪了
定位到上游之后,下一步是让 PHP 自己说话。打开慢日志比猜快得多,在 pool 配置里加两行就行。
第一步,slowlog 指到日志路径、request_slowlog_timeout 设成 5 秒;第二步,reload php-fpm,等一条慢请求进来读栈;第三步,按栈顶去改代码,而不是先动超时数字。request_terminate_timeout 先别设小,留 90 秒——它一旦小于业务耗时,进程会在栈写完之前被杀,慢日志里只剩半条。
慢日志抓到的原文长这样,第一行是时间、进程号,往下是调用栈,越靠下越接近入口。
[19-Nov-2026 10:12:11] [pool www] pid 28471
script_filename = /srv/app/public/index.php
[0x00007f3c1a2b4d50] curl_exec() /srv/app/src/ReportService.php:118
[0x00007f3c1a2b4f20] buildMonthlyReport() /srv/app/src/ReportService.php:74
[0x00007f3c1a2b4b90] {main}
它的价值在于把「慢」变成具体函数。栈顶是 curl_exec,说明时间耗在等外部报表接口上,不是数据库慢查询,也不是 PHP 自己算。
参数上的改动之外还要看 pm.max_children。慢请求会多占一会儿 worker,池子不够就轮到其他接口排队,这是同一笔账。
改完再看同一个导出接口,request_time 落在 3 秒出头,原来钉在 30 秒上的那批记录不再出现,这条路径上的nginx报错499归零。原因不是参数调好了,是那段 curl 换成了本地聚合查询,本来就不该放在请求周期里。
什么时候不该继续查日志
不是所有 499 都值得追。单个 IP 偶尔几条、路径集中在静态资源、时间戳对得上页面切换,这些是正常损耗。
该停下来的是另一种:499 总量在涨,urt 全是空的,request_time 稳定等于某个整数。这说明有一条固定的超时线在切请求,先去找那条线,别再翻 PHP 代码。
还有一种误判要避开。上游真超时,nginx 记的是 504,不是 499。两者同时出现,说明前端和 nginx 的超时设得差不多,谁先到看毫秒;这时候把前端超时调到 nginx 之下更清楚,499 先出现,责任在客户端那边。
这笔账我认为划算:前端超时压到 nginx 之下,慢活挪出请求周期,两条做完 499 就不再冒头;只把超时数字调大,等于把同一段等待往后推,nginx报错499会换个接口继续出现。
若非作者标注皆为李涛自留地原创文章,转载或复制请以超链接形式并注明出处。
- robots文件存在限制指令,Disallow写错会挡掉全站 2026-11-11
- PHP日期函数mktime()如何使用 PHP时间函数mktime()实例代码 2022-10-15
- PhpStudy小皮面板提示80端口被系统占用该怎么办呢? 2022-09-30
- Linux df -h 磁盘空间满了怎么办?5分钟定位大文件并清理 2026-07-02
- 关键词布局区别与联系是什么?按栏目页和详情页分工 2026-11-13
- PHP内置时间函数strtotime()语法用法和实例代码 2022-10-16
