Vercel 在 2026 年 11 月 20 日宣布,Vercel Functions 的 inbound request body 可由原本 4.5MB 提高到 20MiB,目前是 Public Beta。這不是所有專案自動取得的新預設:必須設定 VERCEL_SUPPORT_LARGE_REQUEST_BODY=1,而且 Functions 要使用 4GB performance memory。公告列出的適用 runtime 是 Node.js、Python 與 Bun,也涵蓋 Routing Middleware;Edge runtime 仍維持 4.5MB 上限,超過時會回傳 413。
這項變更直接回應 CSV 匯入、圖片表單、錄音片段與較大 webhook payload 常碰到的限制。Vercel 自己的社群首頁也在 11 月 20 日列出這則 changelog,顯示它已進入產品社群的近期更新流。不過「可以收 20MiB」不等於「所有檔案都該穿過 Function」。上傳路徑還要考慮記憶體、逾時、重試、權限、惡意 payload 與後續處理成本。
啟用前先看三個不容易發現的條件
第一,環境變數是以環境啟用,因此應先只放到 Preview,部署一個接近上限的測試 request,再決定是否進 Production。測試不要只看 HTTP 200;要同時檢查平台 log、function 記憶體、處理時間、重試後是否產生重複資料,以及 20MiB 以上是否如預期被拒絕。
第二,公告說明 opt-in 作用於該環境的整個 project。若同一個 Next.js 專案同時有上傳 API、付款 webhook 與一般表單,不應因上傳需求而放寬每條路由的應用層檢查。每個 endpoint 仍要設定自己的 Content-Type、檔案數量與大小限制,先查 Content-Length 只能作為早期拒絕訊號,因為客戶端可能不提供或偽造它;實際讀取時仍要累計位元組並中止超限輸入。
第三,啟用後 Routing Middleware 仍會執行,也能看到 headers 與 metadata,但不會收到 request body。若既有 middleware 會根據 body 驗證簽章、解析 tenant,或做內容稽核,不能只打開環境變數就上線。應把需要 body 的驗證移到目標 Function,或維持原路徑不啟用大型 body,再以新 project/subdomain 隔離上傳服務。
官方 Functions Limits 文件在本次查核時仍顯示一般 4.5MB request/response body 限制,而 11 月 20 日 changelog 才記載 20MiB 公測的啟用條件。兩者並非一定互相否定:前者描述一般限制,後者是較新的 opt-in beta。實作與驗收應以專案實際回應及最新 changelog 為準,並保留回退開關。
三種上傳架構怎麼選
小型、低頻且要同步驗證的 payload,可以直接送進 Function。例如管理者偶爾匯入一份 CSV,Function 需要先檢查欄位再建立工作。優點是驗證、授權與寫入在同一個 API;缺點是 request 斷線時通常要整包重送,解析程式也會占用 4GB memory Function 的執行資源。程式應採串流或逐列解析,避免先把完整 body 複製成多份 buffer。
圖片、影片、備份檔或使用者可能反覆重傳的內容,更適合由後端簽發短效 upload URL,讓瀏覽器直接傳到 Blob/S3/R2 等物件儲存。Function 只建立上傳授權與接收完成事件,不承載檔案本體。這條路多一道狀態管理,卻能把大檔傳輸、重試與儲存生命週期分開,也比較容易在完成後以 Queue 或 background job 做掃毒、轉檔與 metadata 寫入。
網路不穩、檔案可能超過 20MiB,或需要暫停續傳時,應使用 multipart 或 resumable upload。伺服器要保存 upload ID、part checksum、過期時間與完成狀態;完成 API 必須具備 idempotency,避免客戶端重試造成兩份訂單或兩次匯入。20MiB 上限只是單一 request 的邊界,不會替應用程式提供斷點續傳。
建議的遷移與驗收順序
先從 production log 統計 413 的 endpoint、實際 payload 分布與使用者操作,確認問題真的是 body 上限,而不是反向代理、表單 parser 或應用層限制。接著在 Preview 設定環境變數,確認目標 Function 使用 4GB performance memory,並對 Node.js/Python/Bun runtime 分別驗證,不把 Edge 的結果套用到其他 runtime。
測試至少包含:正常小檔、接近 20MiB、明顯超過上限、錯誤 MIME、壓縮炸彈風險、慢速上傳、中途斷線、同一 request 重送與未授權 request。若使用 Next.js middleware,額外建立一個原本依賴 body 的測試,確認邏輯已搬到 Function;只驗證成功上傳會漏掉這次公測最大的行為差異。
上線後用 feature flag 或環境變數保留回退能力,監看 413、4xx、5xx、執行時間、記憶體與重複工作數量。不要把平台 20MiB 當成公開 API 合約的唯一防線;應用層可以訂得更小,並在前端提前顯示限制。
若檔案只是偶爾超過 4.5MB,且同步處理能在合理時間完成,這次公測可減少架構繞路。若檔案會持續成長、需要續傳、掃描或多階段處理,物件儲存直傳仍是更穩健的主路徑。選擇標準不是「新上限夠不夠大」,而是失敗後能否安全重試、資料是否可追蹤,以及大型輸入會不會拖累同專案的其他 API。