使用小面面板搭建的wordpress本地环境在更新插件时更新失败出错提示出现如下更新失败 504 错误 – phpstudy body{ font: 16px arial,’Microsoft Yahei’,’Hiragino Sans GB’,sans-serif; } h1{ margin: 0; color:#3a87ad; font-size: 26px; } .content{ width: 45%; margin: 0 auto; } .content div{ margin-top: 50px; padding: 20px; background: #d9edf7; border-radius: 12px; } .content dl{ color: #2d6a88; line-height: 40px; } .content div div { padding-bottom: 20px; text-align:center; } HTTP 504 – Gateway Timeout 网关超时 错误说明网关超时服务器响应时间达到超出设定的范围 原因1后端电脑之间 IP 通讯缓慢而产生 解决办法 如果您的 Web 服务器由某一网站托管 只有负责那个网站设置的人员才能解决这个问题。 原因2由于nginx默认的fastcgi进程响应的缓冲区太小造成的错误 解决办法 一般默认的fastcgi进程响应的缓冲区是8K这时可以设置大一点在nginx.conf里加入fastcgi_buffers 8 128k这表示设置fastcgi缓冲区为8块128k大小的空间。当然如果在进行某一项即时的操作, 可能需要nginx的超时参数调大点, 例如设置成60秒:send_timeout 60;经过这两个参数的调整一般不会再提示“504 Gateway Time-out”错误问题基本解决。 原因3PHP环境的配置问题 解决办法 更改php-fpm的几处配置 把max_children由之前的10改为现在的30这样就可以保证有充足的php-cgi进程可以被使用; 把request_terminate_timeout由之前的0s改为60s这样php-cgi进程 处理脚本的超时时间就是60秒可以防止进程都被挂起提高利用效率。 接着再更改nginx的几个配置项减少FastCGI的请求次数尽量维持buffers不变 fastcgi_buffers由 4 64k 改为 2 256k; fastcgi_buffer_size 由 64k 改为 128K; fastcgi_busy_buffers_size 由 128K 改为 256K; fastcgi_temp_file_write_size 由 128K 改为 256K。 重新加载php-fpm和nginx的配置再次测试如果没有出现“504 Gateway Time-out”错误问题解决。 使用手册视频教程BUG反馈官网地址 www.xp.cn这是一个典型的 Nginx PHP-FPM 本地开发环境在执行耗时操作(如WordPress插件下载、解压、安装)时触发的网关超时错误。下面为你详细分析原因并给出针对 小皮面板(phpstudy) 环境的具体解决办法。一、原因详细说明1. 什么是 504 Gateway Timeout?504 错误 表示 Nginx(网关)已经成功连接到了后端的 PHP-FPM 服务但 PHP-FPM 在规定的等待时间内没有完成请求处理并返回结果于是 Nginx 中断了连接返回 504 超时页面。2. WordPress 更新插件时为什么会触发超时?WordPress 后台更新插件时后台会依次执行以下耗时操作连接 WordPress.org 插件仓库(网络请求)下载插件压缩包(可能几MB到几十MB)解压文件(磁盘 I/O 操作)复制文件到插件目录(大量文件写入)执行数据库升级脚本(如有)清理缓存和临时文件在本地环境(小皮面板)中上述任一步骤都可能因以下原因导致 PHP 处理时间超出 Nginx 的忍耐极限原因具体说明PHP 执行时间限制过短默认max_execution_time可能只有 30 秒大插件解压安装不够用PHP-FPM 进程超时request_terminate_timeout默认 0s 或设置过短PHP 进程被强制终止Nginx FastCGI 超时fastcgi_read_timeout默认 60 秒PHP 还没处理完 Nginx 就断开了FastCGI 缓冲区不足插件更新过程中产生大量输出/错误日志超出默认 8K 缓冲区导致阻塞本地网络/磁盘 I/O 慢下载外网插件包慢或机械硬盘解压大文件耗时二、解决办法(针对小皮面板环境)方案一通过小皮面板图形界面修改(推荐最简单)步骤 1修改 PHP 配置(延长执行时间和内存)打开 小皮面板 → 软件管理 → 找到你正在使用的 PHP 版本 → 点击 “设置”切换到 “配置文件” 标签页找到并修改以下参数(如果没有则添加)max_execution_time 300 ; 脚本最大执行时间改为 300 秒 max_input_time 300 ; 数据解析最大时间 memory_limit 512M ; 内存限制大插件需要更多内存 post_max_size 64M ; POST 数据大小 upload_max_filesize 64M ; 上传文件大小点击 保存 → 重启 PHP 服务步骤 2修改 Nginx 配置(延长 FastCGI 超时和缓冲区)小皮面板 → 软件管理 → 找到 Nginx → 点击 “设置”切换到 “配置文件” 标签页找到你的站点 server 块(或直接在 http 块内添加)加入以下配置# 在 http 块或 server 块内添加 fastcgi_connect_timeout 300; fastcgi_send_timeout 300; fastcgi_read_timeout 300; # 关键Nginx 等待 PHP 响应的时间 fastcgi_buffer_size 128k; fastcgi_buffers 8 128k; # 8 块 128k 缓冲区 fastcgi_busy_buffers_size 256k; fastcgi_temp_file_write_size 256k; send_timeout 300; # 发送超时点击 保存 → 重启 Nginx 服务方案二直接修改配置文件(适合熟悉文件操作的用户)1. 修改 PHP-FPM 配置文件路径(根据你的安装路径和PHP版本调整)D:\phpstudy_pro\Extensions\php\php7.4.3nts\php-fpm.conf或D:\phpstudy_pro\Extensions\php\php7.4.3nts\php-fpm.d\www.conf修改内容; 进程数确保有足够进程处理请求 pm.max_children 30 ; 请求超时时间0 表示不限制但建议设一个合理值 request_terminate_timeout 300s2. 修改 Nginx 主配置文件路径D:\phpstudy_pro\Extensions\Nginx\1.15.11\conf\nginx.conf在 http { … } 块内添加http { # ... 其他配置 ... fastcgi_connect_timeout 300; fastcgi_send_timeout 300; fastcgi_read_timeout 300; fastcgi_buffer_size 128k; fastcgi_buffers 8 128k; fastcgi_busy_buffers_size 256k; fastcgi_temp_file_write_size 256k; send_timeout 300; }修改后务必重启 Nginx 和 PHP-FPM 服务。方案三WordPress 层面优化(辅助手段)在 WordPress 根目录的 wp-config.php 文件中添加以下代码增加 WordPress 的内存限制和网络超时// 增加 WordPress 内存限制 define(WP_MEMORY_LIMIT, 512M); // 增加 HTTP 请求超时下载插件包时使用 define(WP_HTTP_TIMEOUT, 300); // 禁用 WordPress 自动更新时的文件系统验证有时能避免卡死 define(FS_METHOD, direct);方案四临时绕过 — 手动安装插件(应急)如果暂时不想修改配置可以到 WordPress.org 手动下载插件的 .zip 文件登录 WordPress 后台 → 插件 → 安装插件 → 上传插件 → 选择 zip 文件安装或者直接解压到 /wp-content/plugins/ 目录下然后在后台启用三、修改后的验证步骤重启服务在小皮面板主界面点击 “重启” 按钮(或分别重启 Nginx 和 PHP)清除缓存如果安装了缓存插件先清除缓存重新更新再次尝试更新插件查看日志如果仍然失败查看以下日志定位问题Nginx 错误日志D:\phpstudy_pro\Extensions\Nginx\1.15.11\logs\error.logPHP 错误日志D:\phpstudy_pro\Extensions\php\php7.4.3nts\logs\php_errors.log问题根源核心解决参数PHP 执行时间不够max_execution_time 300PHP-FPM 进程超时request_terminate_timeout 300sNginx 等待 PHP 超时fastcgi_read_timeout 300缓冲区不足导致阻塞fastcgi_buffers 8 128k最推荐的组合是方案一(图形界面修改 PHP Nginx 超时配置) 方案三(wp-config.php 增加内存和超时)这样能从应用层到服务器层全面解决 WordPress 插件更新的超时问题。原文http://wordpress.zj.cn/jiaocheng/65.html