避免php 504错误的几个小技巧，让你的网站运行更流畅！

发布日期： 2025-10-04 阅读量： 作者： admin

得，今天又折腾了一下午，就为了搞定这个烦人的“504 Gateway Time-out”报错。说起来也是，这网站跑得好好的，流量稍微上来点儿，或者跑个稍微复杂点的后台任务，这504就跟约定好了似的，准时出现。

一开始看到这错误，我脑袋也嗡嗡的。网关超时？啥意思？第一反应是服务器是不是挂了或者网络出问题了。赶紧去瞅了瞅服务器状态，好家伙，CPU、内存都挺正常的，网络连接也没断。这就怪了。

开始排查

没辙，只能一步步来了。我寻思着，这PHP程序是通过Nginx跑的，那是不是Nginx这边等PHP响应等太久了，不耐烦了，就直接给用户甩了个504？

检查Nginx配置

我就先去翻了Nginx的配置文件。网上好多人都说504跟Nginx的超时设置有关系。我找到了类似fastcgi_connect_timeout、fastcgi_send_timeout、fastcgi_read_timeout这些参数。看着默认值好像是有点短，就试着把它们调大了一点，比如都设成了300秒。改完之后，重载了下Nginx配置。心想这下总该好了？

结果，跑那个容易出问题的操作试了试，有时候行，有时候还是跳504。看来问题不全在Nginx这儿。

转向PHP和PHP-FPM

既然Nginx这边调整效果不明显，那问题很可能出在PHP处理本身上了。要么是PHP脚本执行时间太长，要么就是PHP-FPM（就是那个管理PHP进程的玩意儿）那边设置有问题。

先看PHP脚本执行时间。我打开了文件，找到了max_execution_time这个参数。这个是限制单个PHP脚本最长能跑多久的。我看默认是30秒，想着是不是脚本运算量大，30秒不够用？就试着把它也改成了300秒。改完，重启PHP-FPM服务。
再看PHP-FPM的配置。它的配置文件通常叫或者在pool.d目录下的某个文件里。里面有个参数叫request_terminate_timeout。这个参数是告诉PHP-FPM，如果一个请求处理时间超过这个值，就强制干掉这个PHP进程。我一看，好家伙，这里也设置了个超时时间，而且好像比我刚才在里改的max_execution_time优先级更高。如果这个时间设置得短，就算max_execution_time再长也没用，到点照样被PHP-FPM给咔嚓了。于是我把这个值也调大了，跟max_execution_time保持一致或者更大一点，比如300秒或者干脆设成0（表示不限制，但不推荐）。

找到问题所在

改完PHP-FPM的request_terminate_timeout，再次重启PHP-FPM服务。然后，我再去试那个之前老是报504的操作。

这回成了！

等了一小会儿，页面正常加载出来了，没有再跳那个烦人的504。看来这回是找对地方了。主要问题就是PHP-FPM处理请求的超时时间设得太短了，导致一些耗时长的任务还没跑完就被强行中断了，Nginx等不到PHP的正常响应，自然就报504了。

有时候可能还有其他原因，比如有人提到PHP的Xdebug扩展配置不当也可能引起504，但我这边没开Xdebug，所以就没往那方面想。还有就是服务器本身的性能，如果CPU、内存实在跟不上，配置调得再高也没用，该超时的还是会超时。

总结一下

这回解决504的过程，总的来说就是：

先看看是不是Nginx等不及了，调整Nginx相关超时参数。
如果不行，再看看是不是PHP脚本自己执行超时了，调整里的max_execution_time。
重点检查PHP-FPM的配置，特别是request_terminate_timeout，确保它足够长，不会提前终止脚本。

搞定这个问题，心里踏实多了。这种问题，确实挺常见的，尤其网站访问量上去了或者有些批处理任务的时候。关键还是得耐心点，一层层去排查，总能找到原因的。记录下来，下次再碰到心里就有底了。

上一篇: php zookeeper 如何安装配置？跟着这几步轻松搞定

避免php 504错误的几个小技巧，让你的网站运行更流畅！

随便看看