504错误需同步调整Nginx、PHP-FPM及FastCGI超时参数：设proxy_read/send/connect_timeout、fastcgi_read/send/connect_timeout和max_execution_time均≥300秒，禁用xdebug等耗时扩展，并通过日志验证脚本真实执行时间。
如果您在宝塔面板中运行PHP项目时遇到504 Gateway Timeout错误，通常表明Nginx网关在等待后端PHP-FPM响应时超时。以下是调整宝塔面板相关执行超时参数的具体操作步骤：
一、调整Nginx代理超时时间
Nginx作为反向代理，默认的读取、发送和连接超时时间较短，当PHP脚本执行耗时较长时，Nginx会主动断开连接并返回504错误。需延长其与后端PHP-FPM通信的等待时限。
1、登录宝塔面板，进入【网站】→ 找到对应站点 → 点击【设置】→ 切换到【配置文件】选项卡。
2、在server块内location ~ \.php(.*)$段落上方或内部，添加以下三行配置（若已存在则修改为更大值）：
立即学习“PHP免费学习笔记（深入）”；
3、proxy_read_timeout 300;
4、proxy_send_timeout 300;
5、proxy_connect_timeout 300;
6、保存配置文件，然后点击【重载配置】按钮使Nginx生效。
二、调整PHP-FPM最大执行时间
PHP-FPM自身限制了单个请求的最大执行时间（max_execution_time），该值若小于实际脚本运行所需时间，会导致进程被强制终止，Nginx随之返回504。
1、进入宝塔面板【软件商店】→ 找到已安装的PHP版本 → 点击【设置】→ 切换到【配置修改】选项卡。
2、找到max_execution_time参数，将其值修改为300或更高（如600）。
3、同时检查request_terminate_timeout（位于PHP-FPM配置文件中，路径类似/www/server/php/80/etc/php-fpm.conf），确保其值不小于max_execution_time，建议设为300秒。
4、保存修改后，点击【重载服务】按钮重启PHP-FPM进程。
三、调整FastCGI超时参数
Nginx通过FastCGI协议与PHP-FPM交互，其超时控制独立于proxy_*系列指令，必须同步调整以避免协议层中断。
1、回到站点【配置文件】页面，在location ~ \.php(.*)$块内，确认包含以下三项并设置为一致的大于等于300的值：
2、fastcgi_read_timeout 300;
3、fastcgi_send_timeout 300;
4、fastcgi_connect_timeout 300;
5、若未出现，则手动添加至fastcgi_params区块之后、include fastcgi.conf之前的位置。
6、保存并重载Nginx配置。
四、检查并禁用可能触发超时的PHP扩展
某些PHP扩展（如xdebug）在开启调试模式时会显著拖慢脚本执行速度，即使未主动触发断点也可能造成隐式延迟，间接引发504。
1、进入【软件商店】→ 找到对应PHP版本 → 【设置】→ 【禁用函数】选项卡。
2、向下滚动查看已启用的扩展列表，重点关注xdebug、blackfire等性能分析类扩展。
3、若非调试需要，点击对应扩展右侧的【禁用】按钮。
4、禁用后点击【重载服务】重启PHP-FPM。
五、验证PHP脚本实际执行耗时
超时问题根源可能不在配置，而在代码本身存在低效逻辑（如未加索引的数据库查询、死循环、阻塞IO等）。需定位真实瓶颈。
1、在PHP脚本开头加入：error_log("START: " . date('Y-m-d H:i:s') . "\n", 3, "/tmp/php-exec.log");
2、在脚本末尾加入：error_log("END: " . date('Y-m-d H:i:s') . "\n", 3, "/tmp/php-exec.log");
3、访问触发504的URL，随后执行命令查看日志：tail -f /tmp/php-exec.log
4、观察两次时间戳间隔是否超过设定的300秒，若远低于该值仍报错，则需排查Nginx与PHP-FPM间网络或权限问题。
