Problem Definition

웹 서버와 게이트웨이 사이에서 발생하는 502 Bad Gateway 문제 해결 과정

최근 배포했던 서비스에서 다음과 같이 nginx와 관련된 502 Bad Gateway 에러가 발생했습니다.

Resolution

해당 에러는 웹 서버가 게이트웨이 또는 프록시 역할을 하는 서버로부터 잘못된 응답을 받았을 때 발생하며, nginx 1.18.0 Ubuntu는 오류 페이지에서 표시되는 웹 서버 소프트웨어 및 버전 정보를 의미합니다.

오류가 발생하는 대표적인 이유로는 다음과 같습니다.

• 잘못된 구성: 프록시 서버 또는 로드 밸런서가 잘못된 구성 또는 장애로 인해 올바른 응답을 전달하지 못하는 경우

• 백엔드 서버 장애: 백엔드 서버가 작동하지 않거나 제대로 응답하지 않는 경우

• 네트워크 문제: 웹 서버와 프록시 서버 또는 백엔드 서버 간의 네트워크 연결이 불안정하거나 끊어진 경우

저의 경우에는 네트워크 문제로, 과도한 트래픽 또는 응답 지연으로 인한 부하로 인해 해당 오류가 발생했습니다.

그래서 웹 서버와 연결된 AWS EC2 인스턴스를 재부팅하고, 아래과 같은 과정을 통해 프록시 버퍼를 늘리는 방법으로 문제를 해결했습니다.

Process 1.

1. vim 에디터를 사용하여 nginx.conf 파일에 접속

vim /etc/nginx/nginx.conf

2. 최상단의 user www-data; 코드를 user ubuntu; 로 수정

user www-data;
worker_processes auto;
		:
        :

user user ubuntu;
worker_processes auto;
		:
        :

Process 2.

1. vim 에디터를 사용하여 nginx.conf 파일에 접속

vim /etc/nginx/sites-enabled/default

2. location/ 부분에 아래 코드를 추가하여 프록시 버퍼를 증가

proxy_buffer_size          128k;
proxy_buffers              4 256k;
proxy_busy_buffers_size    256k;

위와 같은 방법으로 오류는 해결했지만 개인적으로 이는 급한 불을 끄는 임시적인 방법이라고 생각합니다.

그래서 추후 해당 에러가 재발생하지 않도록 서버 리소스관리 및 부하 분산 등의 조치가 필요하다고 생각합니다.