PHP-FPM返回200但Nginx返回504网关超时问题求助

问题现象 #

访问/wp-admin/admin.php?page=wc-settings&tab=shipping时，Nginx返回504网关超时，日志记录：

139.47.72.206 - - [14/Dec/2022:02:36:56 +0000] "GET /wp-admin/admin.php?page=wc-settings&tab=shipping HTTP/2.0" 504 562 "https://connetixtiles.com/wp-admin/admin.php?page=wc-settings&tab=tax" "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/108.0.0.0 Safari/537.36" "-"

但PHP-FPM访问日志显示该请求已成功返回200状态，处理耗时仅1.826秒：

{"p":"23197","t":"14/Dec/2022:02:33:56 +0000","T":"14/Dec/2022:02:34:58 +0000","d":"1.826","r":"/wp-admin/admin.php?page=wc-settings&tab=shipping","m":"GET","R":"139.47.72.206","C":"84.87","M":"181579776","s":"200","X":"-"}

服务器其他页面运行正常，仅该WooCommerce配送设置页出现此异常。

排查思路 #

• 检查Nginx与PHP-FPM的连接超时配置

  • 核对Nginx配置中的fastcgi_read_timeout、fastcgi_send_timeout值，是否设置为180s（与max_execution_time匹配）。若PHP-FPM已完成响应，但Nginx仍在等待读取数据，可能是读取超时设置过长，或响应传输过程中出现阻塞。
  • 若使用Unix socket连接PHP-FPM，检查socket文件的权限（需确保Nginx进程有权限读取），以及是否存在socket连接队列阻塞的情况；若使用TCP连接，排查服务器内网是否存在丢包、延迟过高的问题。

• 排查PHP-FPM的响应输出异常

  • 查看PHP-FPM错误日志，确认是否存在进程崩溃、连接中断的记录——即使访问日志显示200，也可能出现PHP-FPM在发送响应数据时异常终止的情况。
  • 检查PHP配置中的output_buffering、implicit_flush参数，确认是否存在输出缓冲未及时刷新，导致响应数据滞留在PHP-FPM进程中，未发送给Nginx。

• 定位WooCommerce页面特定逻辑问题

  • 临时禁用WooCommerce的第三方配送插件、自定义配送区域规则，测试页面是否恢复正常，排查是否为插件代码导致响应异常（比如插件在输出响应后仍占用连接资源）。
  • 开启WordPress调试模式，查看该页面是否有隐藏的错误或警告，这些内容可能导致输出中断或延迟。

• 检查服务器资源与进程状态

  • 查看事发时段的服务器监控数据（CPU、内存、磁盘I/O），确认是否存在资源耗尽的情况——比如磁盘I/O过高会导致响应数据写入磁盘缓存缓慢，触发Nginx超时。
  • 通过PHP-FPM的pm.status_path查看进程池状态，检查是否有进程挂起、队列堆积的异常情况。

• 验证Nginx缓冲区配置

  • 检查Nginx的fastcgi_buffer_size、fastcgi_buffers配置，若该页面响应内容过大，缓冲区不足会导致Nginx无法一次性接收全部响应，进而触发超时。可临时调大缓冲区参数测试。
  • 确认是否开启fastcgi_ignore_client_abort，若用户端中途断开连接但未被检测到，可能导致Nginx持续等待无效连接。

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