document.writeln('');
Node.js調用PHP接口頻繁斷連的根本原因是中間設備主動回收空閑HTTP連接,需通過http.Agent配置keepAliveTimeout≥后端超時、PHP禁用輸出緩沖、Nginx啟用HTTP/1.1并清除Connection頭來協同解決。

不是 Node.js 或 PHP 單方面的問題,而是 HTTP 連接在空閑時被中間設備(如 Nginx、負載均衡器、云服務商 SLB、甚至運營商網關)主動回收。默認情況下,keep-alive 連接超時往往只有 60–75 秒,而 Node.js 的 http.Agent 默認 keepAliveTimeout 是 5000ms,遠低于后端實際保活窗口,導致復用連接時突然收到 ECONNRESET 或 socket hang up。
http.Agent 配置長連接 + 心跳參數必須顯式創建并復用 http.Agent 實例,不能依賴默認 agent;關鍵參數要對齊后端(尤其是 Nginx 的 keepalive_timeout):
keepAlive: true — 啟用復用keepAliveMsecs: 30000 — 每 30 秒發一次 TCP keepalive probe(OS 層,需系統支持)maxSockets: 50 — 避免連接數爆炸,按壓測結果調整timeout: 10000 — 請求級超時,和心跳無關,但影響失敗感知速度keepAliveTimeout: 65000 — 必須 ≥ 后端 keepalive_timeout(比如 Nginx 設了 65s,這里至少設 65000)示例:
1 2 3 4 5 6 7 8 9 10 11 12 13 |
|
Node.js 發起的 keep-alive 請求,如果 PHP 響應未及時寫出或被緩沖,連接會卡住,最終被中間層斷開。常見陷阱:
立即學習“PHP免費學習筆記(深入)”;
output_buffering(默認可能為 4096 或 On)→ 導致響應延遲發出ob_start() 但沒 ob_end_flush()flush() 或 ob_flush() 強制推送響應頭+body建議在 PHP 入口加:
1 2 3 4 5 6 7 |
|
很多團隊誤以為“每 30 秒 GET /health 就是心跳”,這反而加重服務負擔,且無法防止真實業務連接被斷。真正有效的保活是:
keepAliveMsecs + OS 內核參數(如 /proc/sys/net/ipv4/tcp_keepalive_time)維持鏈路keepAliveTimeout 對齊后端,讓連接在空閑期不被服務端主動 close注意:http.Agent 不提供內置心跳接口,若真需應用層探測,建議封裝一個帶重試的輕量 HEAD / 請求,在連接復用前觸發,而非固定間隔輪詢。
最易忽略的一點:Nginx 的 proxy_http_version 1.1 和 proxy_set_header Connection 必須配置,否則 upstream 會收不到 keep-alive 指令,所有努力都白搭。