시스템 관리_27 Nginx 및 아파치 HTTP 413 Request Entity Too Large 요청 본문 크기 초과 오류 원인과 완벽 해결 가이드

# 1. 클라이언트 관점: 특정 크기(예: 10MB)의 더미 파일을 생성하여 파일 업로드 요청 테스트
$ dd if=/dev/zero of=test_10mb.bin bs=1M count=10
$ curl -v -F "file=@test_10mb.bin" https://example.com/upload
* Connected to example.com (192.168.1.100) port 443
> POST /upload HTTP/1.1
> Content-Length: 10486016
< HTTP/1.1 413 Request Entity Too Large
< Server: nginx
# -> 파일 전송 직후 웹 서버 레벨에서 413 에러를 즉각 반환하는지 확인

# 2. Nginx 에러 로그에서 413 관련 메시지 확인
$ sudo tail -n 20 /var/log/nginx/error.log
# [출력 예시]
# [error] 18452#18452: *412 client intended to send too large body: 10485760 bytes, client: 203.0.113.10, server: example.com, request: "POST /upload HTTP/1.1", host: "example.com"

# 3. Apache 에러 로그에서 413/LimitRequestBody 관련 메시지 확인
$ sudo tail -n 20 /var/log/apache2/error.log  # 또는 /var/log/httpd/error_log
# [출력 예시]
# [core:error] [pid 1234:tid 1402] Request body exceeds LimitRequestBody limit (10485760 bytes)

# 4. 현재 Nginx 전체 설정에서 client_max_body_size 지시어 확인 (기본값은 1m)
$ sudo nginx -T 2>/dev/null | grep -E "client_max_body_size"
# 아무것도 출력되지 않는다면 Nginx 기본값인 1MB로 엄격하게 제한 중인 상태임

# 5. 현재 Apache 설정에서 LimitRequestBody 지시어 검색
$ sudo grep -rnE "LimitRequestBody" /etc/apache2/ /etc/httpd/ 2>/dev/null

#!/bin/bash
# check_upload_limits.sh - Diagnose HTTP 413 Request Entity Too Large limits across Web & WAS

echo "=========================================="
echo " [HTTP 413 본문 업로드 제한 진단]"
echo "=========================================="

# 1. Nginx 본문 크기 제한 점검
echo -e "\n[1] Nginx 'client_max_body_size' 설정 점검:"
if command -v nginx &>/dev/null; then
    NGINX_BODY_LIMITS=$(nginx -T 2>/dev/null | grep -rnE "client_max_body_size" | grep -v "#")
    if [ -n "$NGINX_BODY_LIMITS" ]; then
        echo "  [설정됨] 명시적인 client_max_body_size 설정 내역:"
        echo "$NGINX_BODY_LIMITS" | sed 's/^/    /'
    else
        echo "  [주의] client_max_body_size 지시어가 설정되어 있지 않습니다."
        echo "  -> Nginx 기본값인 1MB(1m)가 적용되어 1MB 초과 업로드 시 413 발생"
    fi
else
    echo "  - Nginx가 설치되어 있지 않습니다."
fi

# 2. Apache 본문 크기 제한 점검
echo -e "\n[2] Apache 'LimitRequestBody' 설정 점검:"
APACHE_CONF_DIR=""
[ -d "/etc/apache2" ] && APACHE_CONF_DIR="/etc/apache2"
[ -d "/etc/httpd" ] && APACHE_CONF_DIR="/etc/httpd"

if [ -n "$APACHE_CONF_DIR" ]; then
    APACHE_LIMITS=$(grep -rnE "LimitRequestBody" "$APACHE_CONF_DIR" 2>/dev/null | grep -v "#")
    if [ -n "$APACHE_LIMITS" ]; then
        echo "  [설정됨] Apache LimitRequestBody 설정 내역 (단위: Bytes):"
        echo "$APACHE_LIMITS" | sed 's/^/    /'
    else
        echo "  [기본값 사용 중] LimitRequestBody 기본값 0(무제한) 또는 1GB(배포판별 상이) 적용 중"
    fi
else
    echo "  - Apache 설정 디렉터리를 찾을 수 없습니다."
fi

# 3. PHP 환경 점검 (설치된 경우 백엔드 업로드 제한 확인)
echo -e "\n[3] 백엔드(PHP) 업로드 관련 제한 점검:"
if command -v php &>/dev/null; then
    UPLOAD_MAX=$(php -r 'echo ini_get("upload_max_filesize");')
    POST_MAX=$(php -r 'echo ini_get("post_max_size");')
    MEM_LIMIT=$(php -r 'echo ini_get("memory_limit");')
    
    echo "  - upload_max_filesize : ${UPLOAD_MAX} (단일 파일 최대 용량)"
    echo "  - post_max_size       : ${POST_MAX} (전체 POST 본문 최대 용량)"
    echo "  - memory_limit        : ${MEM_LIMIT} (스크립트 실행 메모리)"
    echo "  -> Nginx 제한을 늘려도 위 PHP 설정값이 작으면 파일 저장 시 백엔드 오류 발생"
else
    echo "  - PHP CLI가 감지되지 않아 백엔드 검사를 건너뜁니다."
fi

echo -e "\n=========================================="
echo " [진단 완료]"
echo "=========================================="