PHP报Maximum execution time of 30 seconds exceeded的排查方法(max_execution_time、set_time_limit与php-fpm超时分层定位)

浏览器转了半分钟,页面吐出一行Fatal error: Maximum execution time of 30 seconds exceeded in /var/www/html/import.php on line 87,脚本停在这里,前面的数据处理全白跑。这不是内存不够,memory_limit超了报的是Allowed memory size of xxx bytes exhausted,是另一码事;这一句说的是脚本跑的时间到了上限,被PHP自己掐断。之前接手过一个Excel批量导入,本地几条数据测得好好的,上生产灌两万行就固定在第87行崩,查下来根本不是那行慢,是前面一个没加索引的查询把时间耗光了,报错落点只是时间用完那一刻的位置。

这个报错try/catch拦不住。


报错串里每行都有用

拆开看四段:Fatal error说明是致命错误,不是warning也不是能接住的Exception;Maximum execution time of 30 seconds exceeded里的30来自max_execution_time默认值30秒,改过配置这里跟着变;in后面是超时那一刻正在执行的文件;on line 87给的是行号。最容易误判的就是这个行号,它标的是计时器归零时PHP恰好走到哪,不是耗时代码在哪。见过有人对着第87行反复优化一行数组赋值,实际慢的是第20行那个全表扫描的SQL。


Linux上这30秒只算脚本自己

max_execution_time在非Windows系统上统计的是脚本自身执行时间,system()调起的外部命令、stream读写、数据库查询、sleep()这些发生在脚本之外的时间都不计入。所以一个卡在慢SQL上的请求能跑五分钟也不触发这个报错,而一个纯CPU的密集循环两秒就撞线。实测在同一台机器上把SELECT SLEEP(10)放进脚本,30秒上限根本没动静;换成一百万次字符串拼接,十来秒就抛了。Windows上口径相反,量的是真实流逝的墙钟时间,同一段代码在两台机器上表现不一致,别拿本地结果直接推生产。


8.3起ZTS改了计时方式

这条口径有个版本分界。PHP 7.4、8.0、8.1、8.2、8.3、8.4、8.5,各分支默认行为大体沿用上面的规则,但PHP 8.3.0(2023-11-23)之后,用--enable-zend-max-execution-timers编译的ZTS构建默认改用POSIX per-thread timer计量elapsed time,sleep和I/O等待也一并算进去,等于把老经验推翻了一半。判断手上这台属于哪种,先看php -i输出里有没有相关字样,再看是不是ZTS包,别默认所有8.3都一样。2026年新装的多线程FPM镜像越来越多踩到这条,同一份代码从NTS换到ZTS突然开始报超时,问题不在脚本。

set_time_limit(N)和ini_set('max_execution_time', '120')改的都是这个计时器,set_time_limit每次调用把计时器从当前点清零重来,放进循环里反复调,效果等同于没有上限。这个特性不是漏洞,长任务分批处理时正该这么用,但在Web请求里写set_time_limit(0)等于把闸门拆了,一个慢请求能一直占着FPM的worker。

既然是Fatal error,try/catch (Throwable)接不住它,错误直接终止脚本。想留现场得靠register_shutdown_function注册的回调,它在这类致命错误之后仍会执行,配合error_get_last()把错误类型、文件、行号写进日志,比只看nginx的access日志里那个504有用得多。


真要限墙钟时间得逐层设

靠max_execution_time挡不住外部等待,得在每一层各自设超时。nginx那侧fastcgi_read_timeout默认60s,超了给客户端返504,但它只断开连接,PHP脚本照跑不误,worker一直被占到脚本自己结束;PHP-FPM侧request_terminate_timeout默认0也就是关着的,设成30s才会在到点后杀掉worker,代价是日志里多一条SIGKILL记录。这两层容易混,504是网关等不及,request_terminate_timeout是FPM自己动手,报错现象看着像,处置完全不同。另外max_input_time默认60秒管的是解析POST和上传数据的时间,跟脚本执行时长是两笔账;default_socket_timeout默认60秒管的是stream与socket读,file_get_contents拉一个不响应的URL就卡在这儿。

php -i | grep -i max_execution_time
php --ini
grep -rn "max_execution_time\|request_terminate_timeout\|max_input_time" /etc/php/8.3/fpm/
tail -f /var/log/php8.3-fpm.log

数据访问那几层也得单独设,不然PHP这边放手了,下游还在等。PDO连MySQL可以传PDO::ATTR_TIMEOUT,MySQL还有会话级的max_execution_time(毫秒,只管SELECT)和MAX_EXECUTION_TIME这个hint;PostgreSQL用statement_timeout;cURL分开连与传两个值,CURLOPT_CONNECTTIMEOUT管建连、CURLOPT_TIMEOUT管整个请求。之前现场遇到过一个导出任务,PHP计时器早被set_time_limit重置得形同虚设,根子是一个没设CURLOPT_TIMEOUT的外部接口挂了三分钟,把整个FPM池拖空。


定位慢点再决定改哪层

先把FPM的slowlog打开,request_slowlog_timeout设个5s,慢请求的完整调用栈会落到slowlog文件里,比猜行号靠谱;循环和算法上的耗时用Xdebug或Blackfire抓profile,数据库侧的慢查询翻慢日志。error_get_last()记下的那行只当线索,顺着调用栈往回找真正吃时间的地方。真要跑批,把任务拆成小批次交给队列或后台CLI脚本,CLI下max_execution_time默认0本来就不受限,Web请求则先响应再后台处理,别让浏览器干等。改配置前用php --ini确认读的是哪份php.ini,FPM和CLI经常不是同一个文件,改错了会以为没生效。数据核实到2026年11月。