[nginx] error 로그 유형 및 대응방안

오늘은 nginx 서버를 운영하는 중 발생할 수 있는 주요 에러 로그 유형과 그에 대한 대응 방안을 아래와 같이 정리했습니다. 에러 로그 파일은 일반적으로 /var/log/nginx/error.log에 기록됩니다.

1. 404 Not Found 에러

• 원인: 요청한 파일이나 디렉터리가 서버에 없을 때 발생
• 대응 방안:
  • 경로가 올바른지 확인하고, 필요한 파일이 있는지 확인
  • Nginx 설정 파일에서 root 디렉터리 설정이 정확한지 검토
  • 파일 이름에 대소문자 구분이 있는지 확인

2. 403 Forbidden 에러

• 원인: 서버에 접근 권한이 없을 때 발생
• 대응 방안:
  • 요청한 파일이나 디렉터리에 올바른 권한이 설정되어 있는지 확인
  • Nginx 설정 파일에서 root 디렉터리의 접근 권한 설정을 확인
  • index 디렉터리 설정이 올바른지, 또는 권한에 문제가 있는지 확인

3. 502 Bad Gateway 에러

• 원인: 백엔드 서버가 응답하지 않거나 오류가 발생했을 때, Nginx가 백엔드 서버와 연결할 수 없을 때 발생
• 대응 방안:
  • 백엔드 서버가 제대로 동작하는지 확인
  • Nginx 설정 파일에서 proxy_pass 설정이 올바른지, 백엔드 서버 주소가 올바르게 설정되어 있는지 검토
  • 서버 간 timeout 설정을 조정 (예: proxy_connect_timeout, proxy_read_timeout 등).

4. 504 Gateway Timeout 에러

• 원인: 백엔드 서버가 지정된 시간 안에 응답하지 않을 때 발생
• 대응 방안:
  • 백엔드 서버의 응답 시간이 너무 오래 걸리지 않는지 확인
  • proxy_read_timeout, proxy_connect_timeout, proxy_send_timeout 설정을 늘려 timeout 문제를 해결할 수 있는지 확인

5. 500 Internal Server Error

• 원인: 서버 자체의 설정 오류나 PHP 등의 백엔드 서비스 오류로 인해 발생할 수 있음
• 대응 방안:
  • Nginx 설정 파일에서 syntax error가 없는지 확인
  • PHP-FPM 설정 등 백엔드 서비스의 상태를 확인하고, 서비스가 정상 작동 중인지 확인
  • fastcgi_pass 설정에서 올바른 포트와 소켓이 지정되었는지 검토

6. 413 Request Entity Too Large

• 원인: 클라이언트가 너무 큰 파일을 업로드하려고 할 때 발생
• 대응 방안:
  • Nginx 설정 파일에서 client_max_body_size 값을 조정하여 업로드 허용 크기 확장

7. 429 Too Many Requests

• 원인: 클라이언트의 요청이 너무 많아서 Nginx가 더 이상 처리할 수 없는 상태
• 대응 방안:
  • limit_req 설정을 사용하여 요청 빈도를 제한 가능
  • rate limit를 조정하여 한 사용자가 일정 시간 동안 보낼 수 있는 요청의 수를 관리

8. SSL 관련 에러

• 원인: SSL 인증서 설정 오류, 만료된 인증서 등 SSL 관련 문제로 인해 발생
• 대응 방안:
  • SSL 인증서가 올바르게 설치되어 있는지 확인
  • 인증서 만료 여부를 확인하고, 필요 시 갱신
  • Nginx 설정 파일에서 ssl_certificate와 ssl_certificate_key가 올바르게 설정되어 있는지 확인