504 Gateway Timeout 오류 시 PHP, NGINX 또는 Apache, MySQL 쿼리 설정

504 Gateway Timeout 오류는 PHP 코드 실행 시간이 너무 길어져 서버가 응답하지 못하는 경우 발생합니다. 이를 해결하기 위해 PHP 및 서버 설정에서 몇 가지 값을 조정할 수 있습니다.

1. PHP 설정 변경

php.ini 파일에서 다음 설정 값을 조정하세요:

max_execution_time – PHP 스크립트가 실행될 최대 시간을 늘립니다. 예를 들어:

ini

max_execution_time = 300

기본값은 30초이며, 필요한 만큼 증가시키세요.

memory_limit – PHP가 사용할 최대 메모리를 늘립니다.

ini

memory_limit = 512M

부족한 메모리로 인해 스크립트가 중단될 수도 있으므로 충분히 할당하세요.

2. NGINX 또는 Apache 설정 변경

NGINX 사용 시 nginx.conf에서 fastcgi_read_timeout을 늘립니다.

nginx

fastcgi_read_timeout 300;

이 값이 너무 작으면 PHP-FPM이 응답하지 않을 수 있습니다.

Apache 사용 시 .htaccess 또는 httpd.conf에서 Timeout 값을 조정합니다.

apache

Timeout 300

3. MySQL 쿼리 최적화

만약 데이터 업데이트 시 쿼리 실행 시간이 너무 길다면 인덱스 추가, 쿼리 최적화, 배치 업데이트를 고려해 보세요.

PHP 개발 중에는 다양한 오류가 발생할 수 있는데, 그중 자주 발생하는 오류들은 다음과 같습니다.

1. Fatal Error (치명적 오류)

코드 실행이 중단될 정도로 심각한 오류입니다. 대표적인 예로:

정의되지 않은 함수 호출 (Call to undefined function)

클래스가 존재하지 않음 (Class not found)

메모리 부족 (Allowed memory size exhausted)

해결 방법: 오류 메시지를 확인하고, 함수나 클래스를 올바르게 정의했는지 확인하세요. 메모리 문제는 php.ini에서 memory_limit 값을 조정하면 해결할 수 있습니다.

2. Parse Error (구문 오류)

코드 문법이 잘못된 경우 발생합니다. 예를 들면:

; 누락 또는 괄호((), {}) 오류

잘못된 변수 선언 ($var-name → $var_name처럼 수정)

해결 방법: 코드를 다시 확인하고, 잘못된 문법을 수정하세요. syntax error 메시지가 발생한 위치를 살펴보면 원인을 쉽게 찾을 수 있습니다.

3. Warning (경고)

프로그램 실행에는 영향을 주지 않지만, 예상치 못한 동작이 발생할 가능성이 있는 경우입니다.

include() 또는 require()로 파일이 누락됨 (failed to open stream)

사용되지 않은 변수 (Undefined variable)

배열의 키가 존재하지 않음 (Undefined array key)

해결 방법: 파일 경로가 올바른지 확인하고, isset() 또는 empty()를 사용해 변수가 존재하는지 검증하세요.

4. Notice (알림)

경고보다 낮은 심각도의 오류로, 코드 실행에는 영향을 주지 않지만 주의해야 합니다.

선언되지 않은 변수 사용 (Undefined variable)

배열에서 존재하지 않는 인덱스 접근 (Undefined index)

해결 방법: 코드에서 해당 변수를 미리 정의하거나, 배열 키가 존재하는지 확인하는 조건문을 추가하세요.

5. 500 Internal Server Error

웹 서버에서 PHP 코드 실행 중 문제가 발생하여 서버가 응답하지 못하는 경우입니다.

htaccess 파일 설정 오류

PHP 코드 내부 오류

서버 메모리 부족

해결 방법: 웹 서버 로그를 확인하고, htaccess 설정을 점검하세요. 필요하면 error_reporting(E_ALL);을 추가하여 자세한 오류를 확인할 수 있습니다.

이런 오류들을 잘 관리하면 PHP 개발이 훨씬 더 수월해질 거예요! 

위 설정을 변경한 후 웹 서버를 재시작하세요. 

그래도 문제가 지속되면 로그를 확인해 더 깊은 원인을 분석하는 것이 좋습니다. 

도움이 되었길 바랍니다!