如果應用層已經做了上傳進度條,卻發現進度永遠不動、檔案傳完才一次跳到底,問題很可能不在程式碼,而在反向代理。本文說明 Nginx 預設的請求緩存行為如何拖慢上傳,以及怎麼關掉它。
前端頁面上傳檔案時,Nginx 並沒有把收到的每一塊資料即時轉發給後端,而是先在本地完整緩存,等收完之後再一次轉給後端。結果是:後端拿不到串流的進度,進度條失去意義;整體上傳時間也被明顯拉長,因為多了一層磁碟寫入與讀取。此外,在代理層落地暫存檔案本身就會降低傳輸效率。
本次案例使用 nginx 1.5.6,後端以 Node.js 搭配 formidable 接收檔案。要說明的是,這個問題與後端選用什麼技術無關,Node、Jetty 或其他任何後端都一樣會遇到。相關模組是 ngx_http_core_module,對應的指令則在 ngx_http_proxy_module 中。
兩個步驟:
一、把 nginx 升級到 1.7.11 以上版本。
二、在對應的 location 或 http 區塊加入:
proxy_request_buffering off;
指令的官方說明如下圖:

參考資料:https://nginx.org/en/docs/http/ngx_http_proxy_module.html#proxy_request_buffering
重啟 nginx 後即可生效。
關閉請求緩存之後,Nginx 會在客戶端資料一到就立刻往後端轉,這代表後端必須有能力處理慢速用戶;如果後端是同步阻塞模型,可能會被佔住連線。因此這個設定通常建議只套用在明確需要串流上傳的 location 上,而不是全域關掉。
另外,若同時使用 client_body_temp_path 相關設定或大檔案上傳,也值得一併檢查 client_max_body_size 是否放寬到符合需求。這個方案已經解決了不少 Nginx 上傳檔案被全量緩存的案例,解法當然不只這一種,也歡迎分享你在實務上採用的其他做法。