🚨 504/502 Gateway 오류 해결 포스팅: PHP-FPM 프로세스 고갈 문제 -

• 소제목: 서론

• 504/502 오류가 간헐적으로 발생하자 Nginx와 PHP-FPM 간 통신 문제로 좁혀졌고, php-fpm 로그에서 pm.max_children 도달 및 busy 경고가 반복되었습니다.

• 소제목: 본론

• 근본 원인은 외부 API 중단으로 인한 무한 대기와 프로세스 점유로 PHP 리소스가 고갈된 것이었습니다. 해결책은 서버 RAM에 맞춰 pm.max_children를 증가시키고, request_terminate_timeout(60s)과 proxy_read_timeout(300s)로 타임아웃을 설정하는 것입니다. 적용 후 PHP-FPM과 Nginx를 재시작합니다.

• 소제목: 결론

• 장기적으로는 API 호출의 CURLOPT_TIMEOUT 등 타임아웃을 코드에 반영하고 모니터링을 강화해 재발을 막아야 합니다. 추가로 구성 관리 도구로 경보를 설정하는 것을 권장합니다.