Azure应用网关WAF v2下WordPress插件更新报504网关超时如何解决

问题根因说明 #

该504报错并非WAF规则阻断导致（已验证WAF日志无对应拦截记录、插件实际更新成功），核心原因是插件更新的Web请求执行总耗时超过了链路中某一层的超时阈值，触发了应用网关的超时响应。

可采取的解决措施 #

• 分层适配超时配置
  1. 给WordPress后台路径配置独立的应用网关规则：不要仅使用全局60秒超时，单独为/wp-admin/*路径创建自定义HTTP设置，将请求超时调整为120~300秒，绑定到对应的路径路由规则上，既满足后台更新的长耗时需求，也不影响前端站点的常规超时安全策略
  2. 同步调整后端Web服务超时参数：Nginx环境需修改proxy_read_timeout、fastcgi_read_timeout为对应时长；Apache环境需修改Timeout、ProxyTimeout参数，避免后端服务先于网关超时返回错误
  3. 调整PHP和WordPress执行阈值：修改php.ini中的max_execution_time为120~300秒，同时在WordPress根目录的wp-config.php中添加set_time_limit(300);代码，放开PHP脚本的最大执行时长限制
• 改用命令行工具执行更新
  直接在后端服务器通过WP-CLI工具执行插件、核心版本更新，完全避开Web请求链路，从根源上避免网关超时触发。全量更新插件的命令为wp plugin update --all，也可以配置系统定时任务自动执行更新，无需登录后台操作
• 优化更新链路降低耗时
  1. 在后端服务器测试到WordPress官方更新源的下载速度，若耗时过高可更换为国内的WordPress更新镜像源，大幅降低插件包下载耗时
  2. 体积超过10M的大型插件可手动下载安装包，通过SFTP上传到服务器wp-content/plugins目录下解压安装，避免Web请求长时间传输大文件
• 可选配置WAF例外规则
  虽然无拦截日志，也可将/wp-admin/update.php、/wp-admin/admin-ajax.php两个更新相关路径加入WAF的路径例外列表，跳过请求体检测、规则匹配步骤，减少WAF处理带来的额外耗时

内容的提问来源于stack exchange，提问作者SimonB