504错误主因是Nginx代理超时或后端响应慢，需依次调整proxy超时参数、PHP-FPM配置、优化后端性能、分批处理任务并验证DNS与连通性。
如果您在宝塔面板中部署的网站返回 504 Gateway Timeout 错误，通常是因为 Nginx 作为反向代理，在等待后端服务（如 PHP-FPM、Node.js 或其他上游应用）响应时超出了预设时限。以下是针对该问题的多种调整方法：
一、修改 Nginx 的 proxy 超时参数
该方法适用于使用 Nginx 反向代理至后端服务（如 Tomcat、Python 应用或自定义端口服务）的场景。通过延长代理层等待时间，避免因后端处理较慢而触发超时。
1、登录宝塔面板，进入【网站】→ 选择对应站点 → 【配置文件】。
2、在配置文件中查找 location 块内含 proxy_pass 的配置段。
3、在该 location 块内插入或修改以下三行参数：
proxy_connect_timeout 1200000;
proxy_read_timeout 1200000;
proxy_send_timeout 1200000;
4、保存配置文件，返回【网站】列表，点击【重启】Nginx。
二、调整 PHP-FPM 的 FastCGI 超时设置
该方法适用于网站由 PHP 处理（如 WordPress、DEDECMS、ThinkPHP 等），且 Nginx 通过 FastCGI 协议与 PHP-FPM 通信的场景。超时限制可能同时存在于 Nginx 和 PHP-FPM 两端。
1、进入宝塔面板【软件商店】→ 找到已安装的 PHP 版本 → 点击【设置】→ 【配置修改】。
2、在打开的 php.ini 文件中，定位并修改以下三项：
max_execution_time = 1200
max_input_time = 1200
memory_limit = 512M
3、返回【PHP 管理】→ 【服务】→ 【重载配置】。
4、再进入【网站】→ 对应站点 → 【配置文件】，在 location ~ \.php$ 块中确认或添加以下 FastCGI 超时指令：
fastcgi_connect_timeout 60000;
fastcgi_send_timeout 60000;
fastcgi_read_timeout 60000;
5、保存后重启 Nginx。
三、检查并优化后端服务响应能力
单纯延长超时并不能解决根本问题；若后端服务本身存在性能瓶颈（如慢 SQL、未缓存的高并发请求、阻塞式 I/O），则需同步排查其运行状态，防止持续性超时。
1、进入宝塔【终端】，执行 top 或 htop 查看 CPU 与内存实时占用率。
2、对 MySQL 数据库，检查慢查询日志路径（通常为 /www/server/mysql/data/hostname-slow.log），执行：
sudo tail -n 50 /www/server/mysql/data/*.slow.log
3、若发现大量耗时超过 1 秒的 SQL，进入【数据库】→ 选择对应库 → 【管理】→ 使用 EXPLAIN 分析执行计划。
4、启用 Redis 缓存（宝塔【软件商店】安装 Redis 并开启）并配置 PHP 的 redis 扩展，将高频读取数据（如导航栏、分类列表）写入缓存。
四、分批处理高负载任务以规避超时
该方法适用于静态生成、大批量数据导出、全站索引重建等周期性重负载操作。一次性执行易导致进程阻塞与网关超时，改用分片策略可维持服务可用性。
1、登录服务器终端，进入网站根目录（如 /www/wwwroot/example.com）。
2、对 DEDECMS 类系统，使用命令行分栏目生成静态页：
php /www/wwwroot/example.com/dede/makehtml_list.php -nid=1 -startid=1 -endid=500
3、对自定义脚本任务，添加 sleep(1) 或使用 --limit=100 参数控制单次处理数量。
4、配合宝塔【计划任务】，按每 5 分钟执行一次分段命令，避免单次请求超长阻塞。
五、验证代理链路连通性与 DNS 解析
当 Nginx 反向代理指向域名（而非 IP）时，DNS 解析失败或延迟过高亦会引发连接阶段超时，表现为 proxy_connect_timeout 触发，而非 proxy_read_timeout。
1、进入宝塔【终端】，执行以下命令测试上游服务可达性：
curl -v http://upstream-domain.com:8080/health
2、若返回超时或解析失败，改用 IP 地址替代域名配置 proxy_pass，例如 proxy_pass http://127.0.0.1:8080;。
3、手动刷新 DNS 缓存：
sudo systemctl restart nscd
4、在 Nginx 配置中显式指定 resolver，例如：
resolver 8.8.8.8 114.114.114.114 valid=30s;
