Huny's Dev Blog
huny.dev

Vercel Functions 요청 본문 20 MiB: 413을 줄이기 전에 미들웨어부터 점검하기

Vercel Functions의 20 MiB 요청 본문 공개 베타를 Preview에서 시험하고, Edge 예외와 본문 기반 미들웨어를 점검하는 방법.

Hun Jang
Hun Jang Nov 22, 2026

서버 진입 경로에 따라 같은 크기의 요청도 통과 여부가 달라지는 모습을 표현한 AI 생성 개념 이미지. 실제 제품 화면은 아니다.

10 MiB짜리 파일을 받는 API가 Vercel에서 413을 반환한다면, 함수 코드의 제한보다 플랫폼의 요청 본문 한도를 먼저 확인해야 한다. Vercel은 2026년 11월 20일 기본 4.5 MB에서 최대 20 MiB까지 늘리는 공개 베타를 발표했다. 단순히 업로드 한도만 바뀌는 것은 아니다. 이 기능을 켠 환경에서는 라우팅 미들웨어가 본문을 읽지 못한다. Vercel 공식 발표

Preview에서 런타임과 미들웨어부터 확인한다

프로젝트의 Preview 환경에 VERCEL_SUPPORT_LARGE_REQUEST_BODY=1을 설정하고 해당 환경으로 다시 배포한다. 공식 문서의 조건은 Fluid compute와 Performance 메모리 설정(4 GB)이며, Node.js·Python·Bun 함수가 대상이다. 이 플래그는 개별 경로가 아니라 선택한 환경의 프로젝트 전체에 적용된다. Edge 런타임 함수와 Edge 라우팅 미들웨어는 기존 4.5 MB 제한을 유지한다. 20 MiB는 인바운드 요청 본문 한도이며 응답 한도가 함께 바뀐다는 뜻은 아니다. 413 오류 문서

플래그를 켜면 Routing Middleware는 실행되고 헤더와 메타데이터를 받지만 본문은 받지 않는다. 미들웨어가 웹훅의 원문 본문을 읽어 서명을 검증한다면 검증을 삭제하는 대신 최종 함수로 옮겨야 한다. 원문 바이트에 서명을 붙이는 공급자라면 JSON 파싱이나 재직렬화 전에 검증하고, 검증이 끝나기 전에는 저장이나 후속 작업을 시작하지 않는다. 검증에 필요한 본문을 메모리에 모아야 한다면 해당 경로에는 별도의 보수적인 크기 제한을 둔다.

전환 전후의 413을 구분한다

아래는 테스트용 Preview의 무부작용 엔드포인트에 바이너리 본문을 보내는 예다. 엔드포인트는 application/octet-stream 요청을 받아 본문을 끝까지 소비하도록 만든다. 실제 저장·결제·웹훅 처리 경로에는 보내지 않는다.

같은 엔드포인트에서 플래그를 켜기 전후를 비교한다. 기존 제한과 새 제한을 가르는 구간은 5 MiB다. 20 MiB는 경계 확인용, 21 MiB는 초과 확인용이다. 인증을 요구하는 배포에서 401이나 403이 나왔다면 크기 검증을 마친 게 아니다. 또한 multipart 업로드는 경계 문자열과 각 파트의 헤더까지 요청 본문에 포함하므로 20 MiB 파일이 그대로 들어갈 것이라고 가정하면 안 된다. 앱에서 자체 제한으로 반환한 413과 플랫폼이 함수 실행 전에 반환한 413은 함수 로그와 응답을 함께 보고 구분한다.

파일이 커지는 흐름이라면 저장소에 바로 보낸다

한도가 늘어도 모든 파일을 함수에 통과시킬 필요는 없다. 큰 파일을 지속적으로 받는 기능이라면 함수는 업로드 권한과 메타데이터만 처리하고, 브라우저가 제한된 토큰으로 객체 저장소에 직접 전송하는 구조가 맞다. 반대로 서명된 웹훅이나 JSON API처럼 본문 자체를 서버에서 판단해야 하는 흐름에는 한도 확대가 유용하다. Preview에서 본문 기반 검증을 옮긴 뒤 메모리 사용량과 413 비율을 확인하고 운영 적용을 결정한다. Vercel Blob 클라이언트 업로드 문서

적용 조건은 Vercel 공식 발표와 문서를 기준으로 정리했다. 위 명령은 검증 예시이며 실제 Vercel 배포나 성능 측정을 수행한 결과는 아니다.

추천 글