萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 伺服器教學

Nginx 錯誤 "readv() failed (104: Connection reset by peer)" 解決方案

錯誤現象

[error] readv() failed (104: Connection reset by peer) while reading upstream, client: x.x.x.x, server: host.tld, request: "POST /script.php ..."

Nginx 作為反向代理向上游(PHP-FPM)讀取回應時,連線被對端主動重置(RST),導致 502 Bad Gateway。

根本原因

PHP-FPM 處理請求時間超過 request_terminate_timeout 設定值,進程被強制終止,導致 TCP 連線發送 RST 給 Nginx。預設值通常為 0(無限制)或較小值,長時間運行的腳本(大檔上傳、複雜報表、外部 API 呼叫)易觸發。

解決方案

  1. 編輯 PHP-FPM 設定檔(通常在 /etc/php-fpm.d/www.conf 或 /usr/local/php/etc/php-fpm.conf)
  2. 調整或新增參數:
    request_terminate_timeout = 600

    單位為秒,設為 600(10 分鐘)或 0(關閉超時限制)。

  3. 重載 PHP-FPM:systemctl reload php-fpm 或 service php-fpm reload

關聯參數對照

最佳實踐

  • 長耗時任務改用非同步佇列(Redis/RabbitMQ + Worker)處理,HTTP 請求僅回傳任務 ID
  • 監控 PHP-FPM 慢日誌 slowlog 找出效能瓶頸
  • 生產環境建議設定合理超時而非關閉,防止異常進程佔滿資源
copyright © 萬盛學電腦網 all rights reserved
參數作用層級建議值
request_terminate_timeoutPHP-FPM 進程600 或 0
max_execution_timePHP 腳本邏輯php.ini 中設定,對應調大
fastcgi_read_timeoutNginx 等待上游回應nginx.conf location 區塊設定 ≥ request_terminate_timeout