본문 바로가기
Q&A2026년 6월 27일1분 읽기

nginx에서 파일 업로드하면 413 Request Entity Too Large 뜹니다

서
서버관리_현
조회 834댓글 1

이미지 여러 장 올리는 기능인데요, 작은 건 되는데 10MB 넘는 파일 올리면 바로 이 에러가 뜹니다.

413 Request Entity Too Large

백엔드(Node/Express)에서는 multer 용량 제한을 50MB로 이미 올려놨는데도 그래요. 프론트에서 요청도 안 넘어가는 느낌입니다. nginx 문제일까요?

댓글 1

김김영삼4개월 전

맞습니다. 백엔드까지 도달하기 전에 nginx가 먼저 잘라내는 거예요. nginx의 기본 요청 본문 한도가 1MB라서, 그걸 넘기면 앱에 닿기도 전에 413으로 끊깁니다. multer 설정은 요청이 Express까지 와야 의미가 있는데, 여기선 그 앞에서 막힌 거죠.

해결
# nginx.conf 또는 해당 server/location 블록
http {
client_max_body_size 50M; # 앱과 동일하게 맞추기
}

적용 후 반드시 리로드:

sudo nginx -t        # 문법 검사
sudo nginx -s reload # 무중단 반영
주의할 점
  • 설정 위치 — http, server, location 어디에나 넣을 수 있습니다. 특정 업로드 경로만 크게 하려면 그 location에만 넣으세요.
  • 앱보다 약간 크게 — nginx 50M / multer 50M로 딱 맞추면 경계값에서 애매하니, nginx를 55M 정도로 살짝 여유 두는 걸 권장합니다.
  • 타임아웃도 같이 — 큰 파일은 전송이 오래 걸려서 client_body_timeout, 프록시면 proxy_read_timeout도 넉넉히 잡아야 중간에 안 끊깁니다.

그리고 정말 큰 파일(수백 MB~GB)이라면 서버로 프록시하지 말고 S3 presigned URL로 브라우저에서 직접 업로드하는 구조를 고려하세요. nginx·앱 서버 대역폭을 아낄 수 있습니다.

Ctrl+Enter로 등록