이 가이드에서는 카페24 호스팅 환경을 기준으로 429 에러의 원인과 단계별 해결 방법을 안내합니다.

목차

• 1. 429 에러란 무엇인가?
• 2. 429 에러의 주요 원인 5가지
• 3. 카페24 호스팅에서 해결 방법
• 4. 429 에러 예방 방법
• 5. 자주 묻는 질문 (FAQ)

1. 429 에러란 무엇인가?

HTTP 429 Too Many Requests는 서버가 특정 클라이언트(IP)로부터 지정된 시간 내에 허용 횟수 이상의 요청을 받았을 때 반환하는 응답 코드입니다. 서버 보호 및 자원 관리를 위한 Rate Limiting(요청 속도 제한) 메커니즘에 의해 발생합니다.

주요 증상

• 로그인 페이지(wp-login.php)에 반복 접속 시 429가 나타납니다.
• 특정 시간대에 사이트 전체 접속이 느려지거나 429가 발생합니다.
• WordPress REST API를 사용하는 기능(WooCommerce, 멤버십 플러그인 등)에서 오류가 납니다.
• 검색 엔진 크롤러나 외부 서비스의 API 연동이 갑자기 중단됩니다.

2. 429 에러의 주요 원인 5가지

원인 1 — 악성 봇의 무차별 공격 (Brute Force)

워드프레스 로그인 페이지(wp-login.php)는 전 세계 봇의 주요 공격 대상입니다. 짧은 시간에 수백~수천 번의 로그인 시도가 발생하면 서버가 자동으로 해당 IP를 차단하며 429를 반환합니다.

원인 2 — 과도한 크롤링

검색 엔진 크롤러가 너무 자주 사이트를 크롤링하거나, 악의적인 스크래퍼가 동시에 대량의 페이지를 요청하면 Rate Limiting에 걸립니다.

원인 3 — REST API 남용

WooCommerce, Gutenberg 블록 에디터, 멤버십 플러그인 등이 WordPress REST API를 과도하게 호출하는 경우가 있습니다. 특히 일부 플러그인이 실시간 동기화를 위해 짧은 간격으로 API를 호출하면 429를 유발합니다.

원인 4 — Cloudflare Rate Limiting

Cloudflare를 사용 중이라면 Cloudflare 자체의 Rate Limiting 규칙이나 Bot Fight Mode에 의해 정상 사용자도 429를 받는 경우가 있습니다.

원인 5 — 호스팅의 Rate Limit 설정

카페24 등 공유 호스팅에서는 서버 전체 보호를 위해 특정 임계값 이상의 요청이 들어오면 자동으로 429를 반환하는 경우가 있습니다.

3. 카페24 호스팅에서 해결 방법

1단계 — Wordfence Rate Limiting 설정

Wordfence 보안 플러그인의 Rate Limiting을 통해 악성 봇을 효과적으로 차단할 수 있습니다.

1. 워드프레스 관리자 → [플러그인] → [새 플러그인 추가]에서 “Wordfence” 검색 후 설치 및 활성화
2. [Wordfence] → [All Options] → [Rate Limiting] 섹션으로 이동
3. Enable Rate Limiting을 ON으로 설정합니다.
4. 분당 허용 요청 수를 사이트 규모에 맞게 설정합니다. (일반 블로그: 240, 쇼핑몰: 500 이상)
5. 차단 시간을 설정합니다. (봇 공격 시: 1시간 이상 권장)

2단계 — 로그인 시도 횟수 제한

로그인 페이지 공격을 막기 위한 전용 설정을 추가합니다.

• Wordfence 사용 시: [Wordfence] → [Login Security] → 로그인 시도 제한 설정
• 별도 플러그인 설치: “Limit Login Attempts Reloaded” 플러그인을 설치하면 간단하게 로그인 시도 횟수를 제한할 수 있습니다.

// .htaccess에 wp-login.php 요청 제한 추가 (선택 사항)

    Order Deny,Allow
    Deny from all
    Allow from YOUR.IP.ADDRESS

주의: 위 방법은 특정 IP에서만 관리자 로그인이 가능하게 하므로 고정 IP가 없는 경우 주의해야 합니다.

3단계 — Cloudflare 봇 차단 설정

Cloudflare를 사용 중이라면 봇 차단 기능을 활성화합니다.

1. Cloudflare 대시보드 → [Security] → [Bots]
2. Bot Fight Mode를 활성화합니다. (무료 플랜도 사용 가능)
3. 유료 플랜의 경우 Super Bot Fight Mode로 더 정밀한 봇 차단이 가능합니다.

4단계 — REST API 보호

불필요한 REST API 접근을 제한하여 과도한 API 호출을 줄입니다.

// functions.php에 추가 — 비로그인 사용자의 REST API 접근 제한
add_filter('rest_authentication_errors', function($result) {
    if (!is_user_logged_in()) {
        return new WP_Error('rest_not_logged_in', 
            '로그인이 필요합니다.', 
            array('status' => 401));
    }
    return $result;
});

주의: WooCommerce 등 일부 플러그인은 REST API가 공개 접근 가능해야 합니다. 적용 전 테스트를 권장드립니다.

5단계 — 캐시 플러그인 강화

캐시를 통해 서버가 매 요청마다 PHP를 실행하지 않으면, 동일한 트래픽에서 Rate Limiting 임계값에 훨씬 덜 가까워집니다.

• WP Fastest Cache, LiteSpeed Cache, W3 Total Cache 등 캐시 플러그인을 설치합니다.
• 페이지 캐시, 브라우저 캐시, 데이터베이스 캐시를 모두 활성화합니다.

4. 429 에러 예방 방법

• 보안 플러그인 필수 설치: Wordfence 또는 iThemes Security를 설치하고 Rate Limiting과 로그인 보호를 활성화합니다.
• wp-login.php URL 변경: WPS Hide Login 플러그인으로 로그인 URL을 변경하면 봇의 자동 공격이 대폭 감소합니다.
• Cloudflare 연결: CDN과 봇 차단 기능을 동시에 제공하는 Cloudflare를 사이트에 연결합니다.
• 2단계 인증(2FA): 관리자 계정에 2FA를 적용하면 로그인 페이지 공격에 대한 보안이 크게 강화됩니다.
• robots.txt 최적화: 크롤러가 불필요한 URL을 크롤링하지 않도록 robots.txt를 설정합니다.

5. 자주 묻는 질문 (FAQ)

Q. 429 에러가 로그인 페이지에서만 발생해요.

로그인 페이지에서만 429가 발생하는 경우 무차별 대입 공격(Brute Force)이 원인일 가능성이 높습니다. Wordfence 또는 Limit Login Attempts Reloaded 플러그인으로 로그인 시도 횟수를 제한하시기 바랍니다. 5회 실패 시 30분 차단 정도가 일반적인 설정입니다.

Q. 429 에러가 발생하면 얼마나 기다려야 해결되나요?

서버의 Rate Limiting 설정에 따라 다르지만, 일반적으로 1분~1시간 정도 기다리면 자동으로 해제됩니다. 단, 근본 원인(봇 트래픽, API 과다 호출)을 해결하지 않으면 재발합니다.

Q. 내가 일반 사용자인데 429 에러가 나요.

일반 사용자가 429를 받는 경우, 서버의 Rate Limiting 임계값이 너무 낮게 설정되어 있거나, 같은 IP를 공유하는 다른 사용자의 과도한 요청 때문일 수 있습니다. 나중에 다시 접속하거나, 사이트 운영자에게 Rate Limiting 설정 완화를 요청하시기 바랍니다.

정리 — 429 에러, 이렇게 해결하세요

429 Too Many Requests 에러는 주로 봇 공격, 과도한 크롤링, REST API 남용이 원인입니다. Wordfence Rate Limiting 설정과 Cloudflare 봇 차단을 함께 적용하면 대부분의 429 에러를 예방하고 차단할 수 있습니다.

다른 에러 해결이 필요하시다면 아래 가이드를 참고하시기 바랍니다.

• 워드프레스 에러 해결 완벽 가이드 (전체 에러 총정리)
• 워드프레스 403 Forbidden 에러 해결 가이드
• 워드프레스 500 Internal Server Error 해결 가이드

이 가이드에서는 카페24 호스팅 환경을 기준으로 404 에러의 원인과 단계별 해결 방법을 안내합니다.

목차

• 1. 404 에러란 무엇인가?
• 2. 404 에러의 주요 원인 5가지
• 3. 카페24 호스팅에서 해결 방법
• 4. 301 리다이렉트로 SEO 손실 방지
• 5. 404 에러 예방 방법
• 6. 자주 묻는 질문 (FAQ)

1. 404 에러란 무엇인가?

HTTP 404 Not Found는 클라이언트(브라우저)가 요청한 리소스(페이지, 파일)가 서버에 존재하지 않을 때 반환하는 응답 코드입니다. 서버 자체는 정상이지만 요청한 URL에 해당하는
콘텐츠가 없는 상태입니다.

주요 증상

• 홈페이지는 정상이지만 개별 글이나 페이지에 들어가면 404가 나타납니다.
• 사이트 전체가 404가 되는 경우(홈페이지만 열리고 내부 링크 클릭 시 모두 404)
• 이전에 잘 열리던 URL이 갑자기 404가 되는 경우
• 워드프레스 업데이트나 이전(마이그레이션) 후 대부분의 페이지가 404가 되는 경우

2. 404 에러의 주요 원인 5가지

원인 1 — 퍼머링크(Permalink) 설정 깨짐

워드프레스에서 가장 흔한 404 원인입니다. 퍼머링크는 .htaccess 파일을 통해 동작하는데, 이 파일이 손상되거나 업데이트 과정에서 재생성되지 않으면 모든 내부 링크가
404가 됩니다. 서버 이전, 워드프레스 업데이트, 호스팅 변경 후 자주 발생합니다.

원인 2 — .htaccess 파일 손상 또는 없음

.htaccess 파일이 실수로 삭제되었거나, 잘못된 규칙이 추가된 경우 퍼머링크가 정상 작동하지 않아 404가 발생합니다.

원인 3 — URL(슬러그) 변경

기존에 발행된 글이나 페이지의 슬러그(URL 주소 뒷부분)를 변경하면 이전 URL로 접속하는 방문자나 외부 링크에서 404 에러가 발생합니다.

원인 4 — 콘텐츠 삭제

글이나 페이지를 삭제했지만 외부 사이트나 검색 엔진에 해당 URL이 남아 있으면 404 에러가 발생합니다. 이는 SEO 관점에서도 손실이 발생합니다.

원인 5 — 플러그인 충돌

일부 플러그인이 워드프레스의 URL 처리 방식(rewrite rule)과 충돌하여 특정 페이지에서 404가 발생하는 경우가 있습니다.

3. 카페24 호스팅에서 해결 방법

1단계 — 퍼머링크 재생성 (가장 먼저 시도)

404 에러의 80% 이상이 퍼머링크 재생성으로 해결됩니다. 방법은 매우 간단합니다.

1. 워드프레스 관리자 화면에 접속합니다.
2. [설정] → [퍼머링크] 메뉴로 이동합니다.
3. 설정을 변경하지 않고 [변경사항 저장] 버튼만 클릭합니다.
4. 워드프레스가 .htaccess 파일을 자동으로 재생성합니다.
5. 사이트에서 404가 발생했던 페이지로 다시 접속해봅니다.

2단계 — .htaccess 파일 직접 수정

퍼머링크 재생성이 안 되거나 .htaccess 파일 자체가 없는 경우, FTP로 직접 생성합니다.

1. 카페24 파일 관리자 또는 FTP로 WordPress 루트 디렉터리에 접속합니다.
2. .htaccess 파일이 없으면 새로 만들고, 있으면 아래 내용으로 교체합니다.

# BEGIN WordPress

RewriteEngine On
RewriteBase /
RewriteRule ^index\.php$ - [L]
RewriteCond %{REQUEST_FILENAME} !-f
RewriteCond %{REQUEST_FILENAME} !-d
RewriteRule . /index.php [L]

# END WordPress

주의: 파일 권한이 644로 설정되어야 합니다. 권한이 다르면 워드프레스가 파일을 쓸 수 없어 퍼머링크 재생성이 실패합니다.

3단계 — 플러그인 비활성화 테스트

특정 페이지에서만 404가 발생한다면 플러그인 충돌 가능성을 확인합니다.

1. 카페24 파일 관리자에서 /wp-content/plugins/ 폴더명을 임시 변경합니다.
2. 404 에러가 해결되면 플러그인을 하나씩 다시 활성화하며 원인을 찾습니다.

4. 301 리다이렉트로 SEO 손실 방지

URL이 변경되었거나 글을 삭제한 경우, 기존 URL을 새 URL로 301 리다이렉트하면 방문자 경험과 SEO를 모두 보호할 수 있습니다. Redirection
플러그인을 활용하면 간단하게 설정할 수 있습니다.

Redirection 플러그인으로 301 리다이렉트 설정하기

1. 워드프레스 관리자 → [플러그인] → [새 플러그인 추가]에서 “Redirection” 검색 후 설치 및 활성화합니다.
2. [도구] → [Redirection] 메뉴로 이동합니다.
3. [리디렉션 추가]를 클릭합니다.
4. 소스 URL: 404가 발생하는 이전 URL을 입력합니다.
5. 타겟 URL: 이동할 새 URL을 입력합니다.
6. [저장]을 클릭합니다.

여러 개의 404 URL을 한꺼번에 관리하거나, 404 에러 로그를 확인하고 싶다면 Redirection 플러그인의 로그 기능을 활용하시기 바랍니다.

5. 404 에러 예방 방법

• URL 변경 자제: 발행한 글의 슬러그(URL)는 최대한 변경하지 않는 것이 좋습니다. 변경이 불가피하다면 반드시 이전 URL에서 301 리다이렉트를
  설정합니다.
• 글 삭제 전 리다이렉트 설정: 인기 있는 글을 삭제할 경우 삭제 전에 Redirection 플러그인으로 관련 URL로 리다이렉트를 설정합니다.
• 호스팅 이전 후 바로 퍼머링크 재생성: 사이트를 새 서버로 이전한 직후에는 항상 퍼머링크 재생성을 합니다.
• 404 모니터링: Google Search Console의 커버리지 보고서에서 404 오류 URL을 정기적으로 확인하고 리다이렉트를 설정합니다.
• 커스텀 404 페이지: 워드프레스 테마에 커스텀 404 페이지를 만들어 방문자가 관련 콘텐츠나 홈페이지로 이동할 수 있도록 안내합니다.

6. 자주 묻는 질문 (FAQ)

Q. 퍼머링크를 재생성해도 404 에러가 계속 발생해요.

퍼머링크 재생성 후에도 404가 지속된다면 .htaccess 파일이 제대로 생성되지 않았을 수 있습니다. FTP로 접속하여 .htaccess 파일이
존재하는지, 파일 권한이 644인지 확인하시기 바랍니다. 파일 관리자에서 쓰기 권한이 있어야 워드프레스가 파일을 재생성할 수 있습니다.

Q. 글을 삭제했는데 이전 URL로 들어오는 방문자가 404를 봐요.

삭제된 글의 URL이 외부에서 공유되거나 검색 엔진에 색인된 경우 계속 방문자가 유입됩니다. Redirection 플러그인으로 삭제된 URL에서 관련 내용의 새 URL 또는 홈페이지로 301
리다이렉트를 설정하는 것을 권장드립니다.

Q. 사이트 전체가 404가 아니라 특정 페이지만 404가 나요.

특정 페이지만 404가 발생하는 경우 해당 포스트/페이지가 실제로 삭제되었거나 슬러그(URL)가 변경되었을 가능성이 높습니다. 관리자 → 포스트/페이지 메뉴에서 해당 콘텐츠가 존재하는지 확인하고,
퍼머링크를 재생성해보시기 바랍니다.

Q. 카페24에서 mod_rewrite가 활성화되어 있나요?

카페24 호스팅은 기본적으로 Apache mod_rewrite가 활성화되어 있어 퍼머링크 기능이 정상 동작합니다. mod_rewrite 문제는 카페24보다는 일부 서버호스팅 환경에서 발생합니다.
퍼머링크 재생성으로 해결되지 않는다면 카페24 고객센터(1588-3284)에 문의하시기 바랍니다.

정리 — 404 에러, 이렇게 해결하세요

404 Not Found 에러는 대부분 퍼머링크 재생성으로 해결됩니다. 관리자 화면에서 [설정] → [퍼머링크] → [변경사항 저장]만 클릭하면 됩니다. URL이
변경되거나 글을 삭제한 경우에는 Redirection 플러그인으로 301 리다이렉트를 설정하여 SEO 손실을 방지하시기 바랍니다.

다른 에러 해결이 필요하시다면 아래 가이드를 참고하시기 바랍니다.

• 워드프레스 에러 해결 완벽 가이드 (전체 에러 총정리)
• 워드프레스 500 Internal Server
  Error 해결 가이드
• 워드프레스 403 Forbidden 에러 해결 가이드

이 가이드에서는 카페24 호스팅 환경을 기준으로 413 에러의 원인과 단계별 해결 방법을 안내합니다.

목차

• 1. 413 에러란 무엇인가?
• 2. 413 에러의 원인
• 3. 카페24 호스팅에서 해결 방법
• 4. 413 에러 예방 방법
• 5. 자주 묻는 질문 (FAQ)

1. 413 에러란 무엇인가?

HTTP 413 Request Entity Too Large는 클라이언트가 서버가 허용하는 크기보다 더 큰 데이터를 보낼 때 서버가 거부하며 반환하는 응답 코드입니다. 워드프레스에서는 주로 미디어
업로드(이미지, 동영상, PDF 등) 시 발생합니다.

주요 증상

• 미디어 라이브러리에 파일 업로드 시 413 에러 또는 “업로드한 파일이 php.ini에 정의된 upload_max_filesize보다 큽니다” 메시지가 나타납니다.
• 관리자 화면에서 최대 업로드 파일 크기가 2MB 또는 8MB 등 낮은 값으로 표시됩니다.
• 플러그인 또는 테마 ZIP 파일 업로드 시 실패합니다.

2. 413 에러의 원인

413 에러는 단일 원인으로 발생합니다. PHP 설정의 파일 업로드 크기 제한이 실제 업로드하려는 파일보다 작게 설정되어 있는 경우입니다.

관련 PHP 설정 변수는 두 가지입니다.

주의: post_max_size는 반드시 upload_max_filesize보다 크거나 같아야 합니다. 그렇지 않으면
업로드가 실패합니다.

3. 카페24 호스팅에서 해결 방법

방법 1 — 카페24 PHP 설정에서 직접 변경 (권장)

카페24 호스팅에서는 관리자 페이지에서 PHP 설정을 직접 변경할 수 있습니다.

1. 카페24 호스팅 관리자 접속
2. [나의 서비스 관리] → [호스팅 관리] → [PHP 설정] 클릭
3. upload_max_filesize를 128M으로 변경합니다.
4. post_max_size를 128M으로 변경합니다. (upload_max_filesize 이상이어야 함)
5. [저장하기]를 클릭합니다.
6. 워드프레스 관리자 → 설정 → 미디어에서 최대 업로드 크기가 변경되었는지 확인합니다.

방법 2 — .htaccess 파일에 설정 추가

카페24 PHP 설정이 적용되지 않거나 .htaccess로 오버라이드 가능한 환경에서 사용합니다.

1. 카페24 파일 관리자 또는 FTP로 WordPress 루트의 .htaccess 파일을 편집합니다.
2. 파일 맨 아래에 다음 내용을 추가합니다.

# 파일 업로드 용량 제한 설정
php_value upload_max_filesize 128M
php_value post_max_size 128M
php_value max_execution_time 300
php_value max_input_time 300

방법 3 — wp-config.php에 설정 추가

wp-config.php 파일에 직접 ini 설정을 추가하는 방법입니다.

1. WordPress 루트의 wp-config.php 파일을 편집합니다.
2. /* That's all, stop editing! */ 줄 바로 위에 추가합니다.

// 파일 업로드 용량 제한 설정
@ini_set('upload_max_size', '128M');
@ini_set('post_max_size', '128M');
@ini_set('max_execution_time', '300');

4. 413 에러 예방 방법

• 초기 PHP 설정 최적화: 호스팅 신청 후 첫 WordPress 설치 시 카페24 PHP 설정에서 upload_max_filesize를 128M 이상으로
  미리 설정합니다.
• 이미지 최적화 습관: 업로드 전 이미지를 압축하여 파일 크기를 줄입니다. TinyPNG, ShortPixel 등의 도구를 활용하시기 바랍니다.
• 동영상은 외부 호스팅 활용: 동영상은 용량이 크기 때문에 YouTube, Vimeo에 업로드하고 WordPress에 임베드하는 방식을 권장드립니다.
• 미디어 업로드 제한 플러그인 설정 확인: 일부 보안 플러그인이 업로드 크기를 별도로 제한하는 경우가 있습니다. 플러그인 설정도 함께 확인합니다.

5. 자주 묻는 질문 (FAQ)

Q. 카페24에서 파일 업로드 용량을 늘리려면?

카페24 호스팅 관리자 → [나의 서비스 관리] → [호스팅 관리] → [PHP 설정]에서
upload_max_filesize와 post_max_size를 128M 이상으로 변경하면 됩니다.

Q. PHP 설정을 변경했는데도 413 에러가 계속 나요.

PHP 설정 변경 후에도 413이 지속된다면 웹 서버(Nginx)의 client_max_body_size 설정이 더 낮게 되어 있을 수 있습니다. 카페24
고객센터(1588-3284)에 서버 설정 변경을 요청하시거나, .htaccess에 설정을 추가해보시기 바랍니다.

Q. 동영상 파일을 업로드하려는데 413 에러가 나요.

동영상은 파일 크기가 매우 크기 때문에 단순히 PHP 설정을 늘리는 것만으로 해결이 어려울 수 있습니다. YouTube나 Vimeo에 동영상을 업로드하고 WordPress에 임베드하는 방식을
권장드립니다. 꼭 직접 업로드가 필요하다면 upload_max_filesize를 512M 이상으로 설정하시기 바랍니다.

Q. post_max_size와 upload_max_filesize 중 어느 것을 먼저 올려야 하나요?

두 값을 동일하게 설정하는 것이 가장 좋습니다. 반드시 post_max_size ≥ upload_max_filesize 관계가 유지되어야 합니다.
예를 들어, 둘 다 128M으로 설정하시면 됩니다.

정리 — 413 에러, 이렇게 해결하세요

413 Request Entity Too Large 에러는 카페24 PHP 설정에서 upload_max_filesize와 post_max_size를 128M으로
변경하면 대부분 즉시 해결됩니다. 설정 변경 후 워드프레스 설정 → 미디어에서 최대 업로드 크기가 변경됐는지 확인하시기 바랍니다.

다른 에러 해결이 필요하시다면 아래 가이드를 참고하시기 바랍니다.

• 워드프레스 에러 해결 완벽 가이드 (전체 에러 총정리)
• 워드프레스 504 Gateway Timeout 해결 가이드
• 워드프레스 500 Internal Server
  Error 해결 가이드

이 가이드에서는 카페24 호스팅 환경을 기준으로 PHP Fatal Error의 원인과 단계별 해결 방법을 안내합니다.

목차

• 1. PHP Fatal Error란 무엇인가?
• 2. PHP Fatal Error의 주요 원인 5가지
• 3. 카페24 호스팅에서 해결 방법
• 4. 흰 화면(WSoD) 긴급 해결법
• 5. PHP Fatal Error 예방 방법
• 6. 자주 묻는 질문 (FAQ)

1. PHP Fatal Error란 무엇인가?

PHP Fatal Error는 PHP 스크립트 실행 중 복구할 수 없는 오류가 발생하여 스크립트 실행이 강제로 종료되는 상태입니다. 워드프레스는 PHP로 구동되므로 PHP 치명적 오류가 발생하면
사이트 전체 또는 일부 기능이 완전히 중단됩니다.

주요 증상 유형

2. PHP Fatal Error의 주요 원인 5가지

원인 1 — 플러그인·테마 비호환

가장 흔한 원인입니다. 새로 설치하거나 업데이트한 플러그인/테마가 PHP 버전 또는 기존 다른 플러그인과 충돌하는 경우 Fatal Error가 발생합니다.

원인 2 — PHP 버전 비호환

워드프레스 코어, 플러그인, 테마가 현재 서버의 PHP 버전을 지원하지 않을 때 발생합니다. PHP 5.x, 7.0, 7.2 등 오래된 버전이나, 반대로 플러그인이 아직 지원하지 않는 최신 PHP
버전으로 갑자기 업그레이드할 때 나타날 수 있습니다.

원인 3 — PHP 메모리 부족

PHP 메모리 한도(memory_limit)를 초과하면 “Allowed memory size exhausted” 오류와 함께 Fatal Error가 발생합니다.

원인 4 — 함수 또는 클래스 충돌

두 개 이상의 플러그인이 동일한 함수명이나 클래스명을 사용하면 “Cannot redeclare function” 오류가 발생합니다.

원인 5 — 코드 직접 수정 오류

functions.php나 플러그인 파일을 직접 수정하다 문법 오류(syntax error)가 발생하면 즉시 Fatal Error로 이어집니다.

3. 카페24 호스팅에서 해결 방법

1단계 — 디버그 모드 활성화로 원인 파악

먼저 정확한 오류 메시지를 확인해야 합니다. 카페24 파일 관리자에서 wp-config.php를 편집합니다.

// 오류 디버깅 설정 — wp-config.php에 추가
define('WP_DEBUG', true);
define('WP_DEBUG_LOG', true);
define('WP_DEBUG_DISPLAY', false);  // 화면에 오류 표시하지 않음

설정 후 /wp-content/debug.log 파일을 확인합니다.

2단계 — 플러그인 전체 비활성화

관리자 화면이 열리지 않으므로 FTP를 사용합니다.

1. 카페24 파일 관리자 또는 FTP로 접속합니다.
2. /wp-content/plugins/ 폴더명을 plugins_disabled로 변경합니다.
3. 사이트에 접속을 시도합니다. 접속되면 플러그인이 원인입니다.
4. 폴더명을 원래대로 복구한 후 플러그인을 하나씩 활성화하며 원인을 찾습니다.

3단계 — 기본 테마로 전환

플러그인 비활성화로 해결되지 않으면 테마가 원인일 수 있습니다.

1. /wp-content/themes/현재테마이름/ 폴더명을 임시로 변경합니다.
2. 워드프레스가 기본 테마(Twenty Twenty-Four)로 자동 전환됩니다.
3. 사이트가 정상화되면 테마가 원인입니다. 테마를 최신 버전으로 업데이트하거나 개발사에 문의합니다.

4단계 — PHP 버전 확인 및 변경

워드프레스 관리자 → [도구] → [사이트 상태]에서 PHP 버전을 확인합니다. PHP 7.4 이하라면 업그레이드가 필요합니다.

카페24에서 PHP 버전 변경 방법:

1. 카페24 호스팅 관리자 → [나의 서비스 관리] → [호스팅 관리] → [PHP 설정]
2. PHP 버전을 PHP 8.1 또는 8.2로 변경합니다.
3. [저장하기]를 클릭합니다.
4. 버전 변경 후 플러그인·테마 호환성을 반드시 확인합니다.

5단계 — PHP 메모리 한도 증가

wp-config.php에 아래 코드를 추가합니다.

define('WP_MEMORY_LIMIT', '512M');
define('WP_MAX_MEMORY_LIMIT', '512M');

4. 흰 화면(WSoD) 긴급 해결법

관리자 화면조차 열리지 않는 완전한 흰 화면 상태일 때의 긴급 처치 순서입니다.

1. wp-config.php 수정 (FTP): WP_DEBUG를 true로 설정하고 debug.log에서 오류 확인
2. 플러그인 비활성화 (FTP): plugins 폴더명 변경
3. 테마 전환 (FTP): 현재 테마 폴더명 변경
4. PHP 버전 확인: 카페24 PHP 설정에서 8.1로 변경 시도
5. 메모리 증가: wp-config.php에 WP_MEMORY_LIMIT 512M 추가
6. 백업 복원: 위 방법으로 해결되지 않으면 정상 작동하던 시점의 백업 파일로 복원

카페24에서 백업 복원 방법: 카페24 호스팅 관리자에서 [백업 서비스]를 이용하거나, UpdraftPlus 등 백업 플러그인으로 저장한 외부 백업을 복원하시기
바랍니다.

5. PHP Fatal Error 예방 방법

• 업데이트 전 반드시 백업: 플러그인, 테마, 워드프레스 코어 업데이트 전 전체 백업을 항상 먼저 실행합니다.
• PHP 버전 최신 유지: 카페24 PHP 8.1 이상을 유지하면 보안과 성능이 향상되고 대부분의 최신 플러그인과 호환됩니다.
• 플러그인 호환성 확인: 플러그인 설치 전 WordPress.org에서 PHP 버전 요구사항과 최근 업데이트 날짜를 확인합니다. 1년 이상 업데이트가 없는
  플러그인은 주의가 필요합니다.
• 코드 직접 수정 자제: functions.php나 플러그인 파일 직접 수정은 최소화하고, 수정 전 반드시 백업합니다. 코드 스니펫 추가는 WPCode
  플러그인 활용을 권장드립니다.
• 정기 모니터링: New Relic, UptimeRobot 등으로 사이트 상태를 모니터링하여 문제를 빠르게 감지합니다.

6. 자주 묻는 질문 (FAQ)

Q. 사이트가 완전히 흰 화면(WSoD)으로 나타나요.

흰 화면은 PHP Fatal Error의 대표적인 증상입니다. FTP로 접속하여 plugins 폴더명을 변경해 모든 플러그인을 비활성화하고,
wp-config.php에 WP_DEBUG를 true로 설정하여 debug.log에서 정확한 오류 원인을 파악하세요.

Q. PHP 버전을 올렸더니 플러그인이 작동하지 않아요.

일부 오래된 플러그인은 최신 PHP 버전과 호환되지 않을 수 있습니다. 플러그인을 최신 버전으로 업데이트하거나, 개발이 중단된 플러그인이라면 유사 기능의 최신 대안 플러그인으로 교체하시기
바랍니다.

Q. debug.log 파일에 오류가 너무 많아서 원인을 찾기 어려워요.

debug.log 파일에서 “Fatal error” 또는 “Critical Error” 키워드로 검색하여
치명적인 오류를 먼저 확인합니다. 오류 메시지에 파일 경로가 포함되어 있으므로, 그 경로를 통해 원인 플러그인이나 테마를 파악할 수 있습니다.

Q. 특정 플러그인을 활성화하면 바로 Fatal Error가 나요.

해당 플러그인이 현재 PHP 버전 또는 다른 플러그인과 충돌하는 것입니다. 플러그인을 최신 버전으로 업데이트하고, 그래도 해결되지 않으면 플러그인 개발사에 문의하거나 대안 플러그인을 사용하시기
바랍니다.

정리 — PHP Fatal Error, 이렇게 해결하세요

PHP Fatal Error는 디버그 모드 활성화 → 플러그인 비활성화 → 테마 전환 → PHP 버전 확인 → 메모리 증가 순서로 점검하면 대부분 원인을 찾을 수
있습니다. 무엇보다 정기 백업을 유지하여 복구 옵션을 항상 확보해 두는 것이 중요합니다.

다른 에러 해결이 필요하시다면 아래 가이드를 참고하시기 바랍니다.

• 워드프레스 에러 해결 완벽 가이드 (전체 에러 총정리)
• 워드프레스 500 Internal Server
  Error 해결 가이드
• 워드프레스 503 Service Unavailable 해결
  가이드

이 가이드에서는 카페24 호스팅 환경을 기준으로 403 에러의 주요 원인과 단계별 해결 방법을 안내합니다.

목차

• 1. 403 에러란 무엇인가?
• 2. 403 에러의 주요 원인 5가지
• 3. 카페24 호스팅에서 해결 방법
• 4. 403 에러 예방 방법
• 5. 자주 묻는 질문 (FAQ)

1. 403 에러란 무엇인가?

HTTP 403 Forbidden은 서버가 요청 자체는 이해했지만, 해당 리소스에 접근할 수 없는 경우 반환하는 응답 코드입니다. 파일을 찾지 못하는 404와 달리, 403은 파일은 존재하지만
‘접근 금지’ 상태인 것입니다.

주요 증상

• 사이트 전체에서 403 에러가 발생하는 경우
• wp-admin(관리자 화면)에만 403이 나타나는 경우
• 특정 파일이나 이미지에 접근할 때만 403이 발생하는 경우
• 로그인은 되지만 관리자 화면 내 특정 메뉴에서 403이 나타나는 경우

2. 403 에러의 주요 원인 5가지

원인 1 — 파일 권한(Permission) 오류

가장 흔한 원인입니다. 워드프레스 파일과 폴더에는 적절한 접근 권한이 설정되어야 합니다.

• 폴더(디렉터리): 755 (소유자 읽기/쓰기/실행, 그룹/기타 읽기/실행)
• 파일: 644 (소유자 읽기/쓰기, 그룹/기타 읽기만)

권한이 777로 설정되어 있거나(보안 위협), 400 이하로 설정되어 있으면(접근 불가) 403 에러가 발생합니다.

원인 2 — .htaccess 파일 오류

.htaccess 파일에 잘못된 접근 제한 규칙이 추가되었거나 파일이 손상된 경우 특정 URL이나 디렉터리에 대한 접근이 차단됩니다.

원인 3 — 보안 플러그인의 IP 차단

Wordfence, iThemes Security 등 보안 플러그인이 설정에 따라 특정 IP를 차단하거나, 로그인 시도 횟수 초과로 관리자 IP를 임시 차단하는 경우가 있습니다.

원인 4 — index.php 파일 없음

워드프레스 루트 또는 특정 디렉터리에 index.php 또는 index.html 파일이 없으면 디렉터리 목록이 노출될 수 있으며, 이를 방지하기 위해
서버가 403을 반환하기도 합니다.

원인 5 — 플러그인/테마 충돌

특정 플러그인 또는 테마가 잘못된 접근 제어 코드를 추가하거나, WordPress의 기본 권한 시스템과 충돌하여 403을 유발하는 경우가 있습니다.

3. 카페24 호스팅에서 해결 방법

1단계 — 파일 권한 확인 및 수정

파일 권한 오류가 가장 흔한 원인이므로 먼저 확인합니다.

1. 카페24 호스팅 관리자 → [나의 서비스 관리] → [호스팅 관리] → [파일 관리자] 접속
2. WordPress 루트 디렉터리로 이동합니다.
3. 폴더의 권한이 755인지 확인합니다. 다르다면 우클릭 → 권한 변경에서 수정합니다.
4. 파일의 권한이 644인지 확인합니다. 특히 wp-config.php는 644 또는 600이어야 합니다.

FTP로 한 번에 변경하는 방법 (FileZilla 사용 시):

1. WordPress 루트 폴더를 우클릭 → [파일 권한]
2. 권한에 755 입력 → [하위 디렉터리로 재귀 적용] 체크 → [디렉터리만 적용] 선택
3. 다시 우클릭 → [파일 권한] → 644 입력 → [하위 디렉터리로 재귀 적용] → [파일만 적용]

2단계 — .htaccess 파일 재생성

.htaccess 파일 오류를 수정하는 가장 안전한 방법은 파일을 삭제하고 워드프레스가 자동으로 재생성하게 하는 것입니다.

1. 카페24 파일 관리자에서 WordPress 루트의 .htaccess 파일을 찾습니다. (숨김 파일 보기 활성화 필요)
2. 기존 .htaccess 파일을 .htaccess_backup으로 이름 변경하여 백업합니다.
3. 워드프레스 관리자 화면에서 [설정] → [퍼머링크] → [변경사항 저장]을 클릭합니다.
4. 워드프레스가 새로운 .htaccess 파일을 자동 생성합니다.

직접 .htaccess 파일을 수정할 경우, WordPress 기본 .htaccess 내용만 남기고 나머지는 삭제합니다.

# BEGIN WordPress

RewriteEngine On
RewriteBase /
RewriteRule ^index\.php$ - [L]
RewriteCond %{REQUEST_FILENAME} !-f
RewriteCond %{REQUEST_FILENAME} !-d
RewriteRule . /index.php [L]

# END WordPress

3단계 — 보안 플러그인 비활성화

보안 플러그인이 원인인지 확인합니다.

1. 워드프레스 관리자 화면이 열린다면 → [플러그인] → Wordfence 또는 iThemes Security 비활성화
2. 관리자 화면이 열리지 않는다면 카페24 파일 관리자에서 해당 플러그인 폴더를 비활성화
3. 비활성화 후 403 에러가 해결되면 해당 플러그인의 IP 화이트리스트 설정을 점검합니다.

4단계 — 플러그인 전체 비활성화

3단계로 해결되지 않으면 모든 플러그인을 비활성화하고 원인을 찾습니다.

1. 카페24 파일 관리자에서 /wp-content/plugins/ 폴더명을 plugins_disabled로 변경합니다.
2. 사이트 접속을 시도합니다. 403이 해결되면 플러그인이 원인입니다.
3. 폴더명을 복구하고 플러그인을 하나씩 활성화하며 원인을 찾습니다.

4. 403 에러 예방 방법

• 파일 권한 정기 점검: 새 플러그인이나 테마를 설치한 후 파일 권한이 변경되지 않았는지 확인합니다.
• .htaccess 백업: .htaccess 파일을 수정하기 전 항상 백업을 만들어 둡니다.
• 보안 플러그인 설정 신중히: Wordfence 등의 IP 차단 설정을 너무 엄격하게 적용하지 않도록 주의합니다. 관리자 IP는 반드시 화이트리스트에
  등록합니다.
• 플러그인 업데이트 전 확인: 보안 플러그인 업데이트 후 설정이 초기화되거나 너무 엄격하게 변경되는 경우가 있으니 업데이트 후 확인합니다.

5. 자주 묻는 질문 (FAQ)

Q. 파일 권한이 뭔지 모르겠어요. 어떻게 설정하나요?

파일 권한은 누가 파일을 읽고, 쓰고, 실행할 수 있는지를 숫자로 표현한 것입니다. 워드프레스에서는 폴더(디렉터리)는 755, 파일은 644로 설정하는 것이 기본
원칙입니다. FTP 프로그램에서 파일을 우클릭 → [권한 변경]에서 설정할 수 있습니다.

Q. 403 에러가 wp-admin에서만 발생해요.

보안 플러그인이 관리자 IP를 차단했거나, .htaccess 파일에 wp-admin 디렉터리 접근을 제한하는 규칙이 추가된 경우가 많습니다. 카페24
파일 관리자로 .htaccess를 확인하고 비정상적인 규칙을 삭제하시기 바랍니다.

Q. 카페24에서 파일 권한을 변경하려면?

카페24 호스팅 관리자 → [나의 서비스 관리] → [호스팅 관리] → [파일 관리자]에서 파일을
우클릭하여 권한을 변경할 수 있습니다. 또는 FTP 프로그램(FileZilla 등)으로 접속하여 변경하시기 바랍니다.

Q. 403 에러와 401 에러는 어떻게 다른가요?

401(Unauthorized)은 인증 자체가 되지 않아 접근을 거부한 것이고, 403(Forbidden)은 인증과 무관하게 서버가 접근을 영구적으로 거부한 것입니다. 로그인 화면이 나타나면
401, 에러 페이지만 나타나면 403입니다.

정리 — 403 에러, 이렇게 해결하세요

403 Forbidden 에러는 대부분 파일 권한 수정(755/644), .htaccess 재생성, 보안 플러그인 비활성화 세 가지로 해결됩니다. 이 순서대로
점검하면 대부분의 403 에러를 빠르게 해결할 수 있습니다.

다른 에러 해결이 필요하시다면 아래 가이드를 참고하시기 바랍니다.

• 워드프레스 에러 해결 완벽 가이드 (전체 에러 총정리)
• 워드프레스 500 Internal Server
  Error 해결 가이드
• 워드프레스 503 Service Unavailable 해결
  가이드

이 가이드에서는 카페24 호스팅 환경을 기준으로 504 에러의 주요 원인과 단계별 해결 방법을 안내합니다.

목차

• 1. 504 에러란 무엇인가?
• 2. 504 에러의 주요 원인 5가지
• 3. 카페24 호스팅에서 해결 방법
• 4. 504 에러 예방 방법
• 5. 자주 묻는 질문 (FAQ)

1. 504 에러란 무엇인가?

HTTP 504 Gateway Timeout은 게이트웨이(웹 서버)가 업스트림 서버(PHP, 데이터베이스 등)로부터 지정된 시간 내에 응답을 받지 못할 때 발생하는 오류 코드입니다. 쉽게 말해
서버가 작업을 완료하지 못하고 시간이 초과된 상황입니다.

주요 증상

• 페이지가 로딩 중 멈추다가 504 에러 화면으로 전환됩니다.
• 워드프레스 플러그인 업데이트, 테마 설치, 이미지 대량 업로드 중 에러가 자주 발생합니다.
• WooCommerce 주문 처리나 대용량 데이터 임포트 중에도 나타납니다.
• 사이트의 특정 페이지에서만 반복적으로 발생하기도 합니다.

503 에러와의 차이점

2. 504 에러의 주요 원인 5가지

원인 1 — PHP 실행 시간(max_execution_time) 초과

가장 흔한 원인입니다. PHP 스크립트가 서버에 설정된 최대 실행 시간(기본값 30~60초) 안에 작업을 완료하지 못하면 서버가 연결을 강제로 끊습니다. 대용량 파일 처리, 플러그인 업데이트,
WooCommerce 대량 주문 처리 시 자주 발생합니다.

원인 2 — 느린 데이터베이스 쿼리

최적화되지 않은 플러그인이나 누적된 데이터로 인해 데이터베이스 쿼리 처리 시간이 길어지면 504 에러가 발생합니다. 특히 댓글, 주문, 회원 데이터가 많이 쌓인 사이트에서 자주 나타납니다.

원인 3 — 무거운 플러그인

서버 리소스를 과도하게 사용하는 플러그인(특히 SEO 분석, 백업, 이미지 최적화 플러그인)이 504 에러를 유발하는 경우가 있습니다.

원인 4 — CDN 또는 프록시 서버 설정 오류

Cloudflare 등 CDN의 타임아웃 설정이 서버 처리 시간보다 짧게 설정된 경우, CDN이 먼저 504 에러를 반환합니다.

원인 5 — 외부 API 응답 지연

결제 게이트웨이, 지도 API, 소셜 로그인 등 외부 서비스 API가 느리게 응답하면 PHP 스크립트가 기다리다 타임아웃됩니다.

3. 카페24 호스팅에서 해결 방법

1단계 — 플러그인 전체 비활성화

특정 플러그인이 원인인지 먼저 확인합니다.

1. 카페24 파일 관리자 또는 FTP로 접속합니다.
2. /wp-content/plugins/ 폴더명을 plugins_disabled로 임시 변경합니다.
3. 사이트에 접속하여 504 에러가 해결되는지 확인합니다.
4. 해결되면 폴더명을 복구하고 플러그인을 하나씩 활성화하며 원인 플러그인을 찾습니다.

2단계 — 카페24에서 PHP 실행 시간 늘리기

카페24 호스팅에서는 관리자 페이지에서 직접 PHP 설정을 변경할 수 있습니다.

1. 카페24 호스팅 관리자 접속
2. [나의 서비스 관리] → [호스팅 관리] → [PHP 설정]
3. max_execution_time을 300 (초)으로 변경합니다.
4. memory_limit을 512M으로 변경합니다.
5. [저장하기]를 클릭하고 사이트를 다시 확인합니다.

3단계 — wp-config.php에서 PHP 시간 설정

카페24 PHP 설정이 변경되지 않거나 즉시 적용이 필요한 경우, wp-config.php 파일을 직접 수정합니다.

1. 카페24 파일 관리자에서 WordPress 루트의 wp-config.php를 편집합니다.
2. /* That's all, stop editing! */ 줄 바로 위에 아래 코드를 추가합니다.

// PHP 실행 시간 300초로 늘리기
set_time_limit(300);
define('WP_MEMORY_LIMIT', '512M');
define('WP_MAX_MEMORY_LIMIT', '512M');

4단계 — .htaccess에 타임아웃 설정 추가

WordPress 루트의 .htaccess 파일에 아래 코드를 추가하는 방법도 있습니다.

php_value max_execution_time 300
php_value max_input_time 300

5단계 — CDN 타임아웃 설정 확인

Cloudflare를 사용 중이라면 Cloudflare 대시보드에서 타임아웃 설정을 확인합니다.

• Cloudflare 대시보드 → Speed → Optimization → Protocol Optimization
• 무료 플랜의 경우 100초 타임아웃이 적용됩니다. 이보다 긴 작업은 Cloudflare를 임시 비활성화(Development Mode)하고 테스트합니다.

6단계 — 데이터베이스 쿼리 최적화

불필요한 데이터가 많이 쌓인 경우 데이터베이스를 정리하면 쿼리 속도가 향상됩니다.

• WP-Optimize 플러그인을 설치하고 데이터베이스 최적화를 실행합니다.
• 삭제된 포스트, 리비전, 스팸 댓글, 만료된 트랜지언트 데이터를 제거합니다.

4. 504 에러 예방 방법

• PHP 실행 시간 사전 설정: 카페24 PHP 설정에서 max_execution_time을 초기부터 120~300초로 설정해 두면 대부분의 504 에러를
  예방할 수 있습니다.
• 플러그인 관리: 사용하지 않는 플러그인은 삭제하고, 리소스를 많이 사용하는 플러그인은 가벼운 대안으로 교체합니다.
• 정기적인 DB 최적화: 월 1회 데이터베이스를 정리하여 쿼리 속도를 유지합니다.
• 캐시 플러그인 활용: 페이지 캐시를 사용하면 PHP가 매번 실행되지 않아 504 에러 발생 빈도를 크게 줄일 수 있습니다.
• 업데이트는 비트래픽 시간에: 대용량 플러그인 업데이트나 파일 임포트 작업은 방문자가 적은 새벽 시간에 진행하시기 바랍니다.

5. 자주 묻는 질문 (FAQ)

Q. 504 에러가 특정 페이지에서만 발생해요.

특정 페이지에서만 발생한다면 그 페이지와 연결된 플러그인이나 대용량 쿼리가 원인일 가능성이 높습니다. Query Monitor 플러그인을 설치하여 해당 페이지의 느린 쿼리를 확인하시기 바랍니다.

Q. 504 에러와 503 에러는 어떻게 다른가요?

503은 서버가 서비스 불가 상태(과부하, 유지보수), 504는 서버가 지정된 시간 내에 응답을 받지 못한 경우(시간 초과)입니다. 504는 주로 PHP 실행 시간 초과나 느린 데이터베이스 쿼리가
원인입니다.

Q. 카페24에서 PHP 실행 시간을 늘리려면?

카페24 호스팅 관리자 → [나의 서비스 관리] → [호스팅 관리] → [PHP 설정]에서
max_execution_time을 300초 이상으로 변경합니다. 또는 .htaccess 파일에
php_value max_execution_time 300을 추가합니다.

Q. 504 에러가 해결됐다 재발해요.

일시적으로 해결됐다 재발하는 경우 근본 원인이 해결되지 않은 것입니다. Query Monitor로 느린 쿼리를 찾거나, 원인 플러그인을 찾아 교체하는 것이 필요합니다. 카페24
고객센터(1588-3284)에 서버 로그 분석을 요청하실 수도 있습니다.

정리 — 504 에러, 이렇게 해결하세요

504 Gateway Timeout 에러는 대부분 PHP 실행 시간 연장, 플러그인 비활성화, 데이터베이스 최적화로 해결됩니다. 카페24 호스팅에서는 PHP 설정
메뉴에서 직접 max_execution_time을 늘릴 수 있어 비교적 간단하게 해결할 수 있습니다.

다른 에러 해결이 필요하시다면 아래 가이드를 참고하시기 바랍니다.

• 워드프레스 에러 해결 완벽 가이드 (전체 에러 총정리)
• 워드프레스 500 Internal Server
  Error 해결 가이드
• 워드프레스 503 Service Unavailable 해결
  가이드

이 가이드에서는 카페24 호스팅 환경을 기준으로 503 에러의 주요 원인과 단계별 해결 방법을 안내합니다.

목차

• 1. 503 에러란 무엇인가?
• 2. 503 에러의 주요 원인 5가지
• 3. 카페24 호스팅에서 해결 방법
• 4. 503 에러 예방 방법
• 5. 자주 묻는 질문 (FAQ)

1. 503 에러란 무엇인가?

HTTP 503 Service Unavailable은 서버가 현재 요청을 처리할 수 없는 상태임을 알리는 응답 코드입니다. 서버 자체는 살아있지만, 과부하나 유지보수 상태로 인해 요청 처리를
거부할 때 발생합니다.

주요 증상

• 사이트 전체가 접속되지 않고 503 메시지만 표시됩니다.
• 워드프레스 관리자 화면(wp-admin)도 함께 열리지 않는 경우가 많습니다.
• 새로고침하면 가끔 접속되다가 다시 에러가 나타나는 경우도 있습니다.
• 카페24 호스팅의 경우 “약정 트래픽을 초과하였습니다” 메시지가 함께 표시되기도 합니다.

502 에러와의 차이점

2. 503 에러의 주요 원인 5가지

원인 1 — 카페24 일일 트래픽 초과

카페24 호스팅은 요금제별로 일일 약정 트래픽이 정해져 있습니다. 트래픽이 한도를 초과하면 서버가 자동으로 외부 접속을 차단하며 503 에러 화면을 표시합니다. 특히 인기 있는 글이 SNS에
공유되거나 검색 노출이 갑자기 늘어날 때 자주 발생합니다.

원인 2 — 워드프레스 유지보수 모드 고착

워드프레스 코어, 플러그인, 테마를 업데이트하는 동안 루트 디렉터리에 .maintenance 파일이 자동 생성됩니다. 업데이트가 정상 완료되면 자동으로 삭제되어야 하지만,
업데이트 도중 오류가 발생하면 파일이 남아 있어 지속적인 503 에러를 유발합니다.

원인 3 — 서버 과부하 (리소스 부족)

동시 접속자가 급격히 증가하거나, 특정 플러그인이 많은 서버 리소스를 소비할 경우 서버가 새 요청을 처리할 수 없게 됩니다. 공유 호스팅 환경에서는 다른 사이트의 과부하가 영향을 미치기도 합니다.

원인 4 — 캐시 플러그인 오류

WP Fastest Cache, W3 Total Cache 등의 캐시 플러그인이 업데이트 또는 설정 변경 후 오류를 일으키며 503 에러를 발생시키는 경우가 있습니다.

원인 5 — PHP 설정 한도 초과

PHP 메모리 한도(memory_limit) 또는 동시 실행 프로세스 수가 제한에 도달하면 서버가 새 요청을 거부합니다.

3. 카페24 호스팅에서 해결 방법

1단계 — .maintenance 파일 삭제

가장 먼저 확인해야 할 사항입니다. 카페24 호스팅 관리자의 파일 관리자 또는 FTP를 통해 확인합니다.

1. 카페24 호스팅 관리자 접속 → [나의 서비스 관리] → [호스팅 관리] → [파일 관리자]
2. 워드프레스가 설치된 루트 디렉터리(보통 public_html/)로 이동합니다.
3. .maintenance 파일이 있으면 선택하여 삭제합니다.
4. 삭제 후 사이트에 다시 접속합니다.

주의: .maintenance 파일은 점(.)으로 시작하는 숨김 파일입니다. 파일 관리자에서 “숨김 파일 보기” 옵션을 활성화해야 보입니다.

2단계 — 카페24 트래픽 사용량 확인

카페24 호스팅에서는 트래픽 초과가 503 에러의 가장 흔한 원인입니다. 아래 경로에서 확인하시기 바랍니다.

1. 카페24 호스팅 관리자 접속
2. [나의 서비스 관리] → [호스팅 관리] → [트래픽 사용량] 확인
3. 일일 트래픽이 한도의 100%에 도달해 있다면 트래픽 초과가 원인입니다.

해결 방법:

• 단기: 다음날(자정 이후) 트래픽이 초기화될 때까지 대기합니다.
• 즉시 해결: 카페24 고객센터(1588-3284) 또는 관리자 페이지에서 트래픽 추가 구매를 신청합니다.
• 근본 해결: 더 높은 트래픽 한도의 호스팅 요금제로 업그레이드합니다.

3단계 — 플러그인 전체 비활성화

트래픽 문제가 아니라면 플러그인 충돌을 의심합니다. 관리자 화면이 열리지 않으므로 FTP를 사용합니다.

1. 카페24 파일 관리자 또는 FTP로 접속합니다.
2. /wp-content/plugins/ 폴더명을 plugins_disabled로 임시 변경합니다.
3. 사이트 접속을 시도합니다. 접속되면 플러그인 충돌이 원인입니다.
4. 폴더명을 원래대로 복구한 후 플러그인을 하나씩 활성화하며 원인을 찾습니다.

4단계 — PHP 메모리 한도 늘리기

카페24 호스팅에서 PHP 설정을 변경하는 방법입니다.

1. 카페24 호스팅 관리자 → [나의 서비스 관리] → [호스팅 관리] → [PHP 설정]
2. memory_limit를 256M 또는 512M으로 변경합니다.
3. 또는 WordPress 루트의 wp-config.php 파일에 아래 코드를 추가합니다.

define('WP_MEMORY_LIMIT', '512M');
define('WP_MAX_MEMORY_LIMIT', '512M');

5단계 — 캐시 전체 삭제

관리자 화면이 열린다면 캐시 플러그인의 전체 캐시를 삭제합니다.

• WP Fastest Cache: [WP Fastest Cache] → [캐시 삭제] → [모든 캐시 삭제]
• W3 Total Cache: [Performance] → [Dashboard] → [empty all caches]

관리자 화면이 열리지 않는 경우 FTP로 /wp-content/cache/ 폴더 내 파일을 모두 삭제합니다.

4. 503 에러 예방 방법

• 캐시 플러그인 적극 활용: 캐시를 통해 서버 리소스 소비를 줄이면 트래픽 급증 시에도 서버 부하를 낮출 수 있습니다.
• CDN 연결: Cloudflare 등 CDN을 연결하면 트래픽의 상당 부분을 CDN이 처리하여 호스팅 서버 부하를 크게 줄입니다.
• 트래픽 모니터링: 카페24 호스팅 관리자에서 월별 트래픽 사용 추이를 정기적으로 확인하고, 한도의 80%에 도달하면 업그레이드를 준비합니다.
• 이미지 최적화: 이미지 파일 크기를 줄이면 동일한 트래픽 한도로 더 많은 방문자를 수용할 수 있습니다. ShortPixel, EWWW Image
  Optimizer 등을 활용하시기 바랍니다.
• 업데이트 전 백업: 플러그인, 테마, 코어 업데이트 전 반드시 전체 백업을 진행하여 업데이트 실패 시 빠르게 복구할 수 있도록 준비합니다.

5. 자주 묻는 질문 (FAQ)

Q. 503 에러가 발생했는데 관리자 화면도 안 열려요.

FTP로 서버에 직접 접속해야 합니다. 카페24 호스팅 관리자 → [FTP 관리] → [파일 관리자]에서
.maintenance 파일 삭제를 먼저 시도하세요. 그래도 해결되지 않으면 plugins 폴더명을 변경하여 플러그인을 비활성화합니다.

Q. 카페24에서 트래픽 초과로 503 에러가 났어요. 해결법은?

카페24 호스팅 관리자 → [나의 서비스 관리] → [호스팅 관리]에서 트래픽 사용량을 확인합니다. 초과 시 트래픽 추가 구매 또는 더
높은 사양의 호스팅으로 업그레이드해야 합니다. 자정 이후에는 일일 트래픽이 자동 초기화됩니다.

Q. 503 에러와 502 에러의 차이는 무엇인가요?

502(Bad Gateway)는 서버 간 통신 실패, 503(Service Unavailable)은 서버 자체가 일시적으로 서비스 불가 상태입니다. 503은 트래픽 초과나 유지보수 모드처럼
일시적인 원인인 경우가 많습니다.

Q. 잠깐 기다리면 저절로 해결되기도 하나요?

서버 일시 과부하로 발생한 경우에는 수 분 내에 자동으로 해결되기도 합니다. 그러나 트래픽 초과나 .maintenance 파일 문제라면 직접 조치를 취해야 합니다. 15분이 지나도 해결되지 않으면
위 해결 방법을 순서대로 점검하시기 바랍니다.

정리 — 503 에러, 이렇게 해결하세요

503 Service Unavailable 에러는 대부분 .maintenance 파일 삭제, 트래픽 초과 확인, 플러그인 비활성화 세 가지 방법으로 해결됩니다.
카페24 호스팅 환경에서는 특히 트래픽 초과가 가장 흔한 원인이므로, 먼저 트래픽 사용량을 확인하시기 바랍니다.

다른 에러 해결이 필요하시다면 아래 가이드를 참고하시기 바랍니다.

• 워드프레스 에러 해결 완벽 가이드 (전체 에러 총정리)
• 워드프레스 500 Internal Server
  Error 해결 가이드
• 워드프레스 502 Bad Gateway 해결 가이드

워드프레스 502 Bad Gateway 해결 방법 완벽 가이드

워드프레스 사이트에 접속하려는데 “502 Bad Gateway” 메시지가 나타난다면, 서버 간 통신에 문제가 생긴 상황입니다. 500 에러와 달리 502 에러는 웹 서버와 상위(업스트림) 서버
사이의 연결 문제로 발생합니다. 이번 글에서는 502 에러의 원인과 카페24 호스팅 환경에서 단계별로 해결하는 방법을 안내합니다.

502 Bad Gateway란?

502 Bad Gateway는 게이트웨이 역할을 하는 서버가 업스트림(상위) 서버로부터 유효하지 않은 응답을 받았을 때 발생하는 HTTP 상태 코드입니다. 공유 호스팅 환경에서는 서버 과부하,
CDN 오작동, DNS 전파 지연 등으로 자주 발생합니다.

주요 증상

• 사이트 전체에 “502 Bad Gateway” 메시지가 표시됨
• 관리자 화면과 프론트엔드 모두 접속 불가
• 일정 시간이 지나면 자동으로 해결되는 경우가 있음
• 특정 국가·지역에서만 오류가 발생하는 경우(CDN 문제)
• 도메인을 최근에 이전하거나 변경한 직후 발생

502 에러의 주요 원인 4가지

1. CDN(콘텐츠 전송 네트워크) 충돌

CDN 설정이 잘못되거나 CDN 서버에 일시적인 장애가 발생해 원본 서버와의 통신이 끊길 때 502 에러가 발생합니다. 카페24 무료 CDN을 사용 중인 경우 특히 주의가 필요합니다.

2. DNS 전파 지연 또는 설정 오류

도메인 이전이나 DNS 레코드 변경 후 최대 24~48시간 동안 전파가 완료되지 않아 서버 간 통신이 불안정해집니다. 네임서버나 A 레코드 값이 잘못 설정된 경우에도 동일한 증상이 나타납니다.

3. 서버 과부하 및 타임아웃

방문자 급증이나 무거운 플러그인 실행으로 서버 리소스가 고갈되면 업스트림 서버가 응답 시간을 초과하여 502가 반환됩니다.

4. 캐시·프록시 플러그인 오작동

WP Rocket, W3 Total Cache 등 캐시 플러그인이 업스트림 서버와 충돌하거나 오래된 캐시 파일이 올바르지 않은 응답을 전달하는 경우입니다.

카페24 호스팅에서 502 에러 해결 방법

1단계: 브라우저 캐시 강제 초기화

가장 먼저 브라우저 캐시가 문제는 아닌지 확인합니다. 브라우저가 오래된 502 응답을 캐시로 저장해 계속 보여주는 경우가 있습니다.

• Windows: Ctrl + Shift + Delete → 캐시/쿠키 삭제 후 재접속
• Mac: Cmd + Shift + Delete → 캐시/쿠키 삭제 후 재접속
• 비공개(시크릿) 모드로 접속하여 오류 재현 여부 확인
• 다른 기기 또는 모바일 데이터로 접속 시도

2단계: CDN 설정 임시 비활성화

카페24 무료 CDN을 사용 중이라면 CDN을 임시로 중지하고 오류가 해결되는지 확인합니다.

1. 카페24 호스팅 제어판(hosting.cafe24.com)
   로그인
2. 나의서비스관리 → 호스팅관리 → 연장/변경/추가옵션 클릭
3. 무료 CDN 신청 항목에서 CDN 서비스 상태 확인
4. CDN이 활성화 상태라면 임시로 해제 또는 중지 처리
5. 30분 후 사이트 접속 재확인

오류가 해결된다면 CDN 설정이 원인입니다. CDN을 다시 활성화한 뒤 워드프레스 관리자 화면 → 설정 → 캐시 플러그인 설정에서 CDN URL이 올바르게 입력되어
있는지 확인합니다.

3단계: DNS 설정 점검

최근 도메인을 이전하거나 DNS 레코드를 변경한 경우 설정을 점검합니다.

1. 카페24 호스팅 제어판 로그인
2. 나의서비스관리 → 도메인 관리 → DNS 관리 클릭
3. A 레코드: 도메인이 올바른 서버 IP를 가리키고 있는지 확인
4. CNAME: www 도메인이 루트 도메인을 올바르게 가리키는지 확인
5. 네임서버: 카페24 네임서버(ns1.cafe24.com, ns2.cafe24.com)로 설정되어 있는지 확인

DNS 변경 직후라면 전파가 완료될 때까지 최대 48시간이 소요됩니다. 전파 상태는 DNSChecker.org에서 확인하실 수 있습니다.

4단계: 캐시 및 프록시 플러그인 비활성화

캐시 플러그인이 충돌하는 경우 FTP로 접속하여 해당 플러그인을 비활성화합니다.

1. FTP 클라이언트(FileZilla 등) 또는 카페24 파일 관리자로 접속
2. wp-content/plugins 폴더로 이동
3. 캐시 관련 플러그인 폴더명 변경
   • wp-rocket → wp-rocket_disabled
   • w3-total-cache → w3-total-cache_disabled
4. 사이트 접속 확인
5. 해결된 경우 캐시 플러그인 설정을 새로 구성하거나 대체 플러그인으로 교체

5단계: 카페24 서버 점검 여부 확인

위 방법으로도 해결되지 않는다면, 카페24 서버 자체에 장애가 발생했을 가능성이 있습니다.

• 카페24 호스팅 고객센터(help.cafe24.com) →
  공지사항 확인
• 서버 점검 공지가 있는지 확인
• 카페24 1:1 문의로 현재 서버 상태 문의
• 서버 문제가 아니라면 카페24 지원팀에 서버 로그 분석 요청

502 에러 예방 방법

• CDN 연동 점검: CDN URL과 워드프레스 사이트 URL이 일치하는지 정기적으로 확인합니다
• DNS TTL 관리: 도메인 이전 전 TTL 값을 낮춰 전파 속도를 높입니다
• 서버 리소스 모니터링: 방문자 급증에 대비하여 호스팅 상품 업그레이드를 검토합니다
• 캐시 플러그인 최신화: 캐시 플러그인을 항상 최신 버전으로 유지합니다
• 업타임 모니터링: UptimeRobot 등을 이용하여 502 발생 시 즉시 알림을 받습니다

자주 묻는 질문 (FAQ)

Q. 502 에러가 잠깐 나타났다가 사라지는 이유는 무엇인가요?

서버 부하가 일시적으로 높아졌다가 낮아지거나, CDN 서버가 자체 복구되는 경우 자연스럽게 해결됩니다. 반복적으로 발생한다면 서버 리소스 업그레이드 또는 캐시 플러그인 설정을 재검토해야 합니다.

Q. 502와 503 에러는 어떻게 다른가요?

502는 서버 간 통신 오류로 업스트림 서버에서 잘못된 응답이 온 경우이고, 503은 서버 자체가 일시적으로 서비스를 제공할 수 없는 상태(과부하, 유지보수 모드)를 의미합니다.

Q. 카페24에서 네임서버 변경 후 502 에러가 납니다.

DNS 전파 지연으로 인해 발생하는 일시적인 현상입니다. 변경 후 최대 48시간 동안 간헐적으로 502 에러가 발생할 수 있습니다. DNSChecker.org에서 전파 현황을 확인하며 기다리시기
바랍니다.

정리

워드프레스 502 Bad Gateway 에러는 대부분 CDN 충돌 → DNS 설정 점검 → 캐시 플러그인 비활성화 순서로 점검하면 해결됩니다. 특히 카페24 무료
CDN과 캐시 플러그인을 함께 사용하는 경우 설정 충돌이 자주 발생하므로 주의가 필요합니다.

다음 글에서는 503 Service Unavailable 에러의 원인과 해결 방법을 안내합니다. 서버 과부하와 유지보수 모드로 인한 이 오류 역시 카페24 환경에서의
해결 방법을 함께 살펴보겠습니다.

이 가이드는 워드프레스에서 자주 발생하는 주요 에러 코드별 원인과 해결 방법을 한 곳에 정리한 허브 페이지입니다. 에러 유형을 빠르게 파악하고, 각 에러별 상세
가이드로 연결됩니다.

목차

• 1. 워드프레스 에러가 발생하는 이유
• 2. 에러 발생 시 가장 먼저 해야 할 일
• 3. 에러 코드 빠른 분류표
• 4. 서버 오류 (5xx) 해결법
• 5. 접근 권한 오류 (4xx) 해결법
• 6. PHP 및 코어 오류 해결법
• 7. 에러 없는 워드프레스 유지하는 법
• 8. 자주 묻는 질문 (FAQ)

1. 워드프레스 에러가 발생하는 이유

워드프레스 에러의 원인은 크게 네 가지로 나눌 수 있습니다. 에러가 발생했을 때 이 네 가지 영역을 순서대로 점검하면 대부분의 문제를 해결할 수 있습니다.

• 플러그인·테마 충돌: 새로 설치하거나 업데이트한 플러그인, 테마가 기존 환경과 충돌하는 가장 흔한 원인입니다.
• 서버·호스팅 문제: PHP 메모리 한도 초과, 서버 과부하, 디스크 용량 부족 등 호스팅 환경 설정과 관련된 문제입니다.
• 파일 권한 및 설정 오류: .htaccess 파일 손상, 파일/폴더 권한(Permission) 설정 오류가 다양한 에러를 유발합니다.
• PHP 버전 비호환: 워드프레스 코어, 플러그인, 테마가 현재 서버의 PHP 버전과 맞지 않을 경우 치명적인 오류가 발생합니다.

에러가 발생하면 당황하지 말고, 원인을 좁혀가는 순서로 점검하는 것이 중요합니다. 아래 디버그 방법부터 확인해 보시기 바랍니다.

2. 에러 발생 시 가장 먼저 해야 할 일

에러가 발생했을 때 무작정 시도하기보다, 아래 순서를 따라 진행하면 훨씬 빠르게 해결할 수 있습니다.

1단계 — 디버그 모드 활성화

워드프레스 wp-config.php 파일에 아래 코드를 추가하면 정확한 오류 메시지를 확인할 수 있습니다.

define( 'WP_DEBUG', true );
define( 'WP_DEBUG_LOG', true );
define( 'WP_DEBUG_DISPLAY', false );

설정 후 /wp-content/debug.log 파일에서 상세 오류 내용을 확인하시기 바랍니다.

2단계 — 최근 변경 사항 확인

• 에러 발생 직전에 설치하거나 업데이트한 플러그인·테마가 있다면 먼저 비활성화합니다.
• 워드프레스 코어 업데이트를 진행했다면 wp-content/plugins 폴더를 FTP로 임시 이름 변경하여 전체 비활성화를 시도합니다.

3단계 — 호스팅 서비스 상태 확인

카페24 호스팅의 경우 카페24 고객센터(help.cafe24.com)에서 서비스 공지사항을 확인하거나, 호스팅 관리 페이지에서 서버 상태를 점검합니다.

3. 에러 코드 빠른 분류표

에러 코드를 확인하면 원인의 방향을 빠르게 좁힐 수 있습니다. 아래 분류표를 참고하여 해당 에러의 상세 가이드로 이동하시기 바랍니다.

4. 서버 오류 (5xx) 해결법

5xx 계열 에러는 서버 측 문제로 발생합니다. 서버 설정, 리소스, 플러그인 충돌이 주요 원인입니다.

500 Internal Server Error — 가장 흔한 서버 오류

워드프레스에서 가장 자주 발생하는 에러입니다. 원인이 다양하여 단계별 점검이 필요합니다.

• 주요 원인: .htaccess 파일 손상, 플러그인 충돌, PHP 메모리 한도 초과, 파일 권한 오류
• 빠른 해결법: 플러그인 전체 비활성화 → .htaccess 재생성 → PHP 메모리 512M으로 증가

→ 워드프레스 500 에러 완벽 해결 가이드 (단계별
상세 방법 확인)

502 Bad Gateway — 서버 간 통신 단절

웹 서버와 업스트림 서버(PHP-FPM, 백엔드) 사이의 통신이 실패할 때 발생합니다.

• 주요 원인: PHP-FPM 프로세스 과부하, CDN 설정 오류, DNS 전파 지연
• 빠른 해결법: CDN 임시 비활성화 → DNS 설정 확인 → 호스팅 서버 재시작 요청

→ 워드프레스 502 에러 완벽 해결 가이드

503 Service Unavailable — 서버 과부하

서버가 일시적으로 요청을 처리할 수 없는 상태입니다. 주로 트래픽 급증이나 유지보수 모드 활성화 시 발생합니다.

• 주요 원인: 트래픽 급증으로 인한 서버 과부하, 워드프레스 업데이트 중 유지보수 모드 고착, 메모리 부족
• 빠른 해결법: FTP로 /wp-content/.maintenance 파일 삭제 → 캐시 플러그인 비활성화 → 호스팅 리소스 확인

504 Gateway Timeout — 응답 시간 초과

서버가 지정된 시간 안에 처리를 완료하지 못할 때 발생합니다. 대용량 작업이나 느린 플러그인이 원인인 경우가 많습니다.

• 주요 원인: 복잡한 쿼리로 인한 PHP 실행 시간 초과, 외부 API 응답 지연, 서버 리소스 부족
• 빠른 해결법: wp-config.php에 set_time_limit(300) 추가 → 호스팅 PHP 실행 시간
  연장 요청 → 불필요한 플러그인 비활성화

5. 접근 권한 오류 (4xx) 해결법

4xx 계열 에러는 클라이언트(브라우저)의 요청 자체에 문제가 있거나, 서버가 접근을 거부할 때 발생합니다.

400 Bad Request — 잘못된 요청

브라우저가 서버에 잘못된 형식의 요청을 보낼 때 발생합니다. 쿠키나 캐시 문제인 경우가 많습니다.

• 주요 원인: 손상된 브라우저 쿠키, 잘못된 URL 형식, HTTP 헤더 오류
• 빠른 해결법: 브라우저 쿠키·캐시 삭제 → 다른 브라우저에서 접속 시도 → WordPress 쿠키 설정 확인

→ 워드프레스 400 에러 해결 가이드

403 Forbidden — 접근 금지

서버가 요청 자체는 이해했지만 접근 권한이 없어 거부하는 경우입니다.

• 주요 원인: 파일 권한 오류(폴더: 755, 파일: 644 필요), .htaccess의 잘못된 접근 제한 설정, 보안 플러그인의 IP 차단
• 빠른 해결법: FTP로 파일 권한을 755/644로 변경 → .htaccess 파일 재생성 → 보안 플러그인 임시 비활성화

404 Not Found — 페이지를 찾을 수 없음

워드프레스에서 404 에러는 주로 퍼머링크 설정 문제로 발생합니다.

• 주요 원인: 퍼머링크 구조 깨짐, .htaccess 파일 손상, 페이지/포스트 삭제
• 빠른 해결법: 워드프레스 관리자 → [설정] → [퍼머링크] → [변경사항 저장] 클릭 (퍼머링크 재생성)

429 Too Many Requests — 요청 횟수 초과

짧은 시간 안에 너무 많은 요청이 들어올 때 서버가 요청을 거부합니다. 봇 트래픽이나 자동화 스크립트가 원인인 경우가 많습니다.

• 주요 원인: 악성 봇의 과도한 크롤링, 로그인 무차별 대입 공격, 플러그인의 과도한 API 호출
• 빠른 해결법: 로그인 시도 제한 플러그인 설치 → Wordfence 등 보안 플러그인으로 봇 차단 → 호스팅에서 Rate Limiting 설정

413 Request Entity Too Large — 파일 크기 초과

업로드하는 파일이 서버 허용 용량을 초과할 때 발생합니다.

• 주요 원인: PHP의 upload_max_filesize 및 post_max_size 제한 초과
• 빠른 해결법: php.ini 또는 .htaccess에 아래 코드 추가:

php_value upload_max_filesize 128M
php_value post_max_size 128M

카페24 호스팅에서는 [호스팅 관리] → [PHP 설정]에서 수치를 변경할 수 있습니다.

6. PHP 및 코어 오류 해결법

PHP Fatal Error / Critical Error

PHP 코드 자체의 오류로, 플러그인이나 테마가 현재 PHP 버전과 맞지 않을 때 주로 발생합니다. 워드프레스 화면이 완전히 흰색으로 나타나는 “흰 화면(White Screen of Death,
WSoD)” 증상과 함께 나타나는 경우가 많습니다.

• 주요 원인: PHP 버전 비호환, 플러그인/테마의 코드 오류, 메모리 한도 초과

단계별 해결 방법

1. 디버그 모드 활성화: wp-config.php에 define('WP_DEBUG', true); 추가 후 오류
   메시지 확인
2. 플러그인 전체 비활성화: FTP로 /wp-content/plugins/ 폴더명을
   plugins_disabled로 변경
3. 기본 테마로 전환: FTP로 현재 테마 폴더명을 변경하면 워드프레스가 기본 테마(Twenty Twenty-Four)로 전환됩니다.
4. PHP 버전 확인 및 변경: 카페24 호스팅 관리자에서 PHP 8.1 이상으로 변경합니다.
5. wp-config.php 메모리 증가: define('WP_MEMORY_LIMIT', '512M'); 추가

흰 화면(WSoD) 긴급 해결법

관리자 화면조차 열리지 않는 경우, FTP 또는 카페24 파일 관리자를 통해 직접 접근해야 합니다.

1. 카페24 호스팅 관리자 → [FTP 관리] → [파일 관리자] 접속
2. /wp-content/plugins/ 폴더를 /wp-content/plugins_bk/로 이름 변경
3. 사이트가 정상화되면 플러그인 폴더를 복구하고 하나씩 활성화하며 원인을 파악합니다.

7. 에러 없는 워드프레스 유지하는 법

대부분의 워드프레스 에러는 사전 예방으로 방지할 수 있습니다. 다음 체크리스트를 정기적으로 확인하시기 바랍니다.

필수 예방 체크리스트

카페24 호스팅 권장 설정값

• PHP 메모리 한도: 최소 256MB, 권장 512MB
• 최대 업로드 파일 크기: 최소 64MB (이미지·영상 업로드 많을 경우 128MB 이상)
• PHP 버전: PHP 8.1 이상 (8.2 또는 8.3 권장)
• PHP 실행 시간: 최소 60초, 복잡한 사이트는 120~300초

카페24 호스팅에서는 [나의 서비스 관리] → [호스팅 관리] 메뉴에서 위 설정 대부분을 직접 변경할 수 있습니다. 변경 후에는 사이트가 정상 동작하는지 반드시
확인하시기 바랍니다.

8. 자주 묻는 질문 (FAQ)

Q. 워드프레스 500 에러가 갑자기 발생했어요. 어떻게 해야 하나요?

가장 먼저 플러그인을 전체 비활성화한 후 에러가 해결되는지 확인합니다. 해결되면 플러그인을 하나씩 활성화하며 원인을 찾습니다. 해결되지 않으면 .htaccess 파일을 초기화하거나 PHP 메모리
한도를 늘려보세요. 자세한 내용은 500 에러 해결
가이드를 확인하시기 바랍니다.

Q. 에러 발생 시 가장 먼저 확인해야 할 것은?

1) 워드프레스 디버그 모드를 켜서 정확한 오류 메시지를 확인합니다. 2) 최근 수행한 변경 사항(플러그인 설치, 테마 변경, 업데이트)을 점검합니다. 3) 호스팅 서버 상태를 확인합니다. 이 세
가지 순서로 접근하면 대부분의 에러 원인을 빠르게 찾을 수 있습니다.

Q. 카페24 호스팅에서 PHP 버전을 변경할 수 있나요?

네, 가능합니다. 카페24 호스팅 관리자 페이지에서 [나의 서비스 관리] → [호스팅 관리] → [PHP 버전 선택] 메뉴에서 PHP 버전을 변경할 수 있습니다.
PHP 8.1 또는 8.2를 권장드립니다.

Q. 워드프레스 에러를 미리 예방할 수 있나요?

네, 정기적인 백업 설정, 플러그인·테마·코어 업데이트 관리, 보안 플러그인 설치, PHP 버전 최신 유지를 통해 대부분의 일반적인 에러를 예방할 수 있습니다. 특히 업데이트 전
백업은 반드시 실행하는 습관을 들이시기 바랍니다.

Q. 에러가 해결되지 않으면 어떻게 해야 하나요?

기본 해결 방법으로 해결되지 않는 경우, 카페24 고객센터(1588-3284)에 문의하거나 워드프레스 공식 포럼에서 도움을 받을 수 있습니다. 문의 시 정확한 에러 메시지, 사용 중인 플러그인·테마 목록, PHP
버전 정보를 함께 제공하면 빠른 해결에 도움이 됩니다.

정리 — 워드프레스 에러, 이렇게 대응하세요

워드프레스 에러는 처음에는 당황스럽지만, 에러 코드의 의미를 알고 순서대로 접근하면 대부분 해결할 수 있습니다. 이 가이드의 핵심을 정리하면 다음과 같습니다.

• 5xx 에러: 서버 문제로 플러그인 비활성화, .htaccess 재생성, 호스팅 설정 확인 순서로 점검합니다.
• 4xx 에러: 접근 권한 문제로 파일 권한 설정, 퍼머링크 재생성, 쿠키·캐시 삭제로 대응합니다.
• PHP 오류: PHP 버전 업그레이드와 플러그인 호환성 확인이 핵심입니다.
• 예방: 정기 백업, 업데이트 관리, PHP 버전 유지가 최선의 방어책입니다.

각 에러별 더 자세한 해결 방법은 아래 개별 가이드를 통해 확인하시기 바랍니다.

• 워드프레스 500 Internal Server
  Error 완벽 해결 가이드
• 워드프레스 502 Bad Gateway 완벽 해결 가이드
• 워드프레스 400 에러 해결 가이드

이 글은 워드프레스 에러 해결 완벽 가이드와 연계한 심층 가이드입니다.

목차

• 1. 디버그란 무엇이고 왜 필요한가?
• 2. WP_DEBUG — 기본 디버그 모드
• 3. debug.log 파일 분석 방법
• 4. Query Monitor 플러그인 활용
• 5. 사이트 상태(Site Health) 도구
• 6. 플러그인·테마 충돌 디버그
• 7. 브라우저 개발자 도구 활용
• 8. 서버 에러 로그 확인 (카페24)
• 9. 고급 디버그 기법
• 10. 자주 묻는 질문 (FAQ)

1. 디버그란 무엇이고 왜 필요한가?

디버그(Debug)는 소프트웨어의 오류(버그)를 찾아내고 제거하는 과정입니다. 워드프레스에서 에러가 발생하면 단순히 “에러가 났다”는 사실만으로는 원인을 찾기 어렵습니다. 디버그 도구를 사용하면
정확히 어느 파일의 몇 번째 줄에서 무슨 오류가 발생했는지를 알 수 있어 빠른 해결이 가능합니다.

워드프레스 디버그 도구 전체 목록

2. WP_DEBUG — 기본 디버그 모드

WP_DEBUG는 워드프레스에 내장된 가장 기본적인 디버그 시스템입니다. wp-config.php 파일에 상수 값을 설정하여 동작합니다.

WP_DEBUG 설정 방법

카페24 파일 관리자 또는 FTP로 WordPress 루트의 wp-config.php 파일을 열고,
/* That's all, stop editing! */ 줄 바로 위에 아래 코드를 추가합니다.

// ===== 디버그 설정 시작 =====
define('WP_DEBUG', true);           // 디버그 모드 활성화
define('WP_DEBUG_LOG', true);       // debug.log 파일에 오류 기록
define('WP_DEBUG_DISPLAY', false);  // 화면에 오류 표시 안 함 (운영 환경 필수)
define('SCRIPT_DEBUG', true);       // 압축되지 않은 JS/CSS 로드
// ===== 디버그 설정 끝 =====

각 상수의 역할

WP_DEBUG

• true: PHP 오류, 경고, 알림을 모두 감지합니다.
• false (기본값): 오류를 감지하지 않습니다.
• 운영 사이트에서는 false로 유지해야 합니다.

WP_DEBUG_LOG

• true: 발생한 모든 오류를 /wp-content/debug.log 파일에 기록합니다.
• WP_DEBUG_DISPLAY가 false여도 로그 파일에는 계속 기록됩니다.
• 파일 경로를 직접 지정할 수도 있습니다: define('WP_DEBUG_LOG', '/home/user/logs/debug.log');

WP_DEBUG_DISPLAY

• true: 오류 메시지를 화면(브라우저)에 직접 표시합니다.
• false (권장): 화면에는 표시하지 않고 log 파일에만 기록합니다.
• 운영 사이트에서 true로 설정하면 방문자에게 오류 코드가 노출되어 보안에 위험합니다.

SCRIPT_DEBUG

• true: 워드프레스가 압축·최소화된 JS/CSS 대신 원본 파일을 로드합니다.
• JavaScript 오류 디버그 시 유용합니다.

디버그 완료 후 반드시 비활성화

디버그 작업이 끝나면 반드시 아래와 같이 변경하시기 바랍니다.

define('WP_DEBUG', false);
// WP_DEBUG_LOG, WP_DEBUG_DISPLAY 줄은 삭제하거나 주석 처리

3. debug.log 파일 분석 방법

debug.log는 워드프레스가 감지한 PHP 오류를 시간순으로 기록하는 텍스트 파일입니다. WP_DEBUG와 WP_DEBUG_LOG가 모두 true일 때
/wp-content/debug.log 경로에 자동 생성됩니다.

debug.log 파일 열기

1. 카페24 파일 관리자 → /www/wp-content/ 폴더
2. debug.log 파일을 클릭하여 내용 확인 (또는 FTP로 다운로드)
3. 파일이 보이지 않으면 [숨김 파일 보기]를 활성화합니다.

오류 유형별 의미

오류 유형	심각도	의미	대응
Fatal error	치명적	스크립트 실행 중단. 사이트 다운 원인	즉시 해결 필요
Parse error	치명적	PHP 문법 오류. 코드를 실행할 수 없음	즉시 해결 필요
Warning	경고	실행은 되지만 잠재적 문제 존재	가능한 빠른 해결
Notice	알림	권장되지 않는 방식 사용	여유 있을 때 해결
Deprecated	정보	더 이상 지원되지 않는 함수 사용	업데이트 시 해결

debug.log에서 원인을 빠르게 찾는 방법

1. “Fatal error” 키워드로 검색합니다. (Ctrl+F 또는 Cmd+F)
2. 오류 메시지에서 파일 경로를 확인합니다. 예: /wp-content/plugins/plugin-name/class.php on line 123
3. 경로에 plugins/플러그인명이 있으면 해당 플러그인이 원인입니다.
4. 경로에 themes/테마명이 있으면 테마가 원인입니다.

debug.log 주요 오류 패턴

# 플러그인 함수 충돌 (두 플러그인이 같은 함수명 사용)
Fatal error: Cannot redeclare function_name() ... in /plugins/plugin-a/file.php

# 정의되지 않은 함수 호출 (플러그인 누락 또는 비활성화)
Fatal error: Call to undefined function plugin_function() in /plugins/plugin-b/file.php

# 메모리 부족
Fatal error: Allowed memory size of 134217728 bytes exhausted

# PHP 버전 비호환
Fatal error: Uncaught TypeError: Argument must be of type string, bool given

4. Query Monitor 플러그인 활용

Query Monitor는 워드프레스의 성능과 오류를 실시간으로 분석하는 개발자용 플러그인입니다. 데이터베이스 쿼리, PHP 오류, HTTP API 호출, 훅(Hook) 등 매우 상세한 정보를
관리자 바에서 바로 확인할 수 있습니다.

Query Monitor 설치 방법

1. 워드프레스 관리자 → [플러그인] → [새 플러그인 추가]
2. “Query Monitor” 검색 후 설치 및 활성화
3. 사이트에 접속하면 관리자 바에 “0.43s / 42 queries / 8.5 MB” 형태의 통계가 표시됩니다.

Query Monitor 주요 패널 설명

Queries (데이터베이스 쿼리)

• 페이지 로드 시 실행된 모든 SQL 쿼리를 표시합니다.
• 실행 시간이 긴 쿼리(느린 쿼리)는 붉은색으로 강조됩니다.
• Caller 컬럼에서 해당 쿼리를 발생시킨 플러그인/테마를 확인합니다.
• 0.05초 이상 걸리는 쿼리는 최적화 대상입니다.

PHP Errors (PHP 오류)

• debug.log 없이도 PHP 오류를 실시간으로 확인할 수 있습니다.
• Fatal, Warning, Notice, Deprecated 등 모든 오류 유형을 표시합니다.

Hooks (훅)

• 페이지 로드 시 실행된 모든 WordPress 훅(action/filter)을 표시합니다.
• 특정 훅이 예상대로 실행되는지 확인할 때 유용합니다.

HTTP API Calls

• 외부 API 호출(결제 게이트웨이, 지도, 소셜 로그인 등)을 모니터링합니다.
• 느린 외부 API 응답이 504 에러를 유발하는지 확인할 수 있습니다.

Request (요청 정보)

• 현재 페이지의 WordPress 쿼리 변수, 매칭된 rewrite rule 등을 표시합니다.
• 404 에러나 퍼머링크 문제 디버그에 유용합니다.

5. 사이트 상태(Site Health) 도구

워드프레스 내장 사이트 상태 도구는 서버 환경, 플러그인 호환성, 보안 설정 등을 자동으로 점검하고 개선 방법을 안내합니다.

접근 방법

워드프레스 관리자 → [도구] → [사이트 상태]

주요 점검 항목

[상태] 탭

• 치명적 문제 (빨강): 즉시 해결이 필요한 항목입니다.
• 권장 사항 (노랑): 개선하면 좋은 항목입니다.
• 통과 (녹색): 정상 상태인 항목입니다.

[정보] 탭

• PHP 버전, 메모리 한도, 최대 실행 시간 등 서버 정보
• 활성화된 플러그인과 테마 목록
• 데이터베이스 정보
• 파일 권한 상태

사이트 상태 정보는 고객센터나 개발자에게 문제를 보고할 때도 유용합니다. [정보 복사] 버튼으로 전체 환경 정보를 클립보드에 복사할 수 있습니다.

6. 플러그인·테마 충돌 디버그

워드프레스 에러의 상당수는 플러그인 또는 테마 간의 충돌에서 발생합니다. 체계적으로 원인을 격리하는 방법을 안내합니다.

플러그인 비활성화 테스트 (이분 탐색법)

활성화된 플러그인이 많을 때 빠르게 원인을 찾는 방법입니다.

1. 활성화된 플러그인의 절반을 비활성화합니다.
2. 에러가 해결되면 방금 비활성화한 플러그인 중에 원인이 있습니다.
3. 해당 그룹을 다시 절반씩 나누어 반복합니다.
4. 원인 플러그인을 찾을 때까지 반복합니다.

관리자 화면 접속이 불가능할 때 (FTP 사용)

1. 카페24 파일 관리자 → /www/wp-content/
2. plugins 폴더명을 plugins_disabled로 변경 → 전체 비활성화
3. 문제 해결 시 폴더명 원래대로 복구 → 플러그인을 하나씩 활성화하여 원인 탐색

기본 테마로 전환하여 테마 원인 확인

1. 관리자가 열린다면: 외모 → 테마 → Twenty Twenty-Four 활성화
2. 관리자가 열리지 않는다면: FTP로 현재 테마 폴더명 변경
3. 에러 해결 시 테마가 원인 → 테마 업데이트 또는 재설치

7. 브라우저 개발자 도구 활용

PHP 오류가 아닌 JavaScript 오류, CSS 깨짐, 느린 리소스 로딩 등은 브라우저 개발자 도구에서 확인합니다.

개발자 도구 열기

• Chrome/Edge: F12 또는 Ctrl+Shift+I (Mac: Cmd+Option+I)
• Firefox: F12 또는 Ctrl+Shift+I

주요 탭별 활용법

Console 탭

• JavaScript 오류를 확인합니다.
• 빨간색 오류 메시지가 있으면 해당 스크립트 파일과 줄 번호를 확인합니다.
• 워드프레스 관리자 화면이 깨지거나 JS 기능이 동작하지 않을 때 필수 확인 항목입니다.

Network 탭

• 페이지 로드 시 모든 HTTP 요청과 응답 코드를 확인합니다.
• 404(빨강), 500, 502, 503 등 에러 응답이 있는 요청을 찾습니다.
• 느리게 로드되는 리소스를 파악합니다.

Application 탭

• 캐시, 쿠키, 로컬 스토리지 데이터를 확인하고 삭제할 수 있습니다.
• 캐시 문제로 의심될 때 모든 캐시를 삭제하고 테스트합니다.

8. 서버 에러 로그 확인 (카페24)

PHP Fatal Error가 WordPress가 감지하기 전에 서버 레벨에서 발생하는 경우 WordPress의 debug.log에 기록되지 않을 수 있습니다. 이때는 서버 에러 로그를 직접
확인합니다.

카페24에서 에러 로그 확인 방법

1. 카페24 호스팅 관리자 → [나의 서비스 관리] → [호스팅 관리]
2. [로그 관리] 또는 [에러 로그] 메뉴 클릭
3. 날짜와 시간이 에러 발생 시점과 일치하는 항목을 찾습니다.

FTP로 직접 에러 로그 확인

카페24의 에러 로그는 일반적으로 아래 경로에 있습니다.

# 카페24 에러 로그 일반 경로
/www/logs/error.log
/logs/php-error.log

9. 고급 디버그 기법

var_dump와 error_log를 활용한 임시 디버그

특정 변수의 값을 확인하거나 코드 실행 흐름을 추적할 때 사용합니다.

// debug.log에 변수 내용 기록
error_log('변수 확인: ' . print_r($variable, true));

// 배열 또는 객체 전체 내용 확인
error_log(var_export($array, true));

// 실행 시점 확인
error_log('이 코드가 실행됨 — ' . date('Y-m-d H:i:s'));

wp_die()로 중간 값 확인

// 코드 실행을 중단하고 값 출력
wp_die('
' . print_r($variable, true) . '
');
주의: 이 방법은 개발 환경에서만 사용하고, 운영 환경에서는 반드시 제거해야 합니다.
SAVEQUERIES로 DB 쿼리 추적
// wp-config.php에 추가
define('SAVEQUERIES', true);

// 코드에서 사용
global $wpdb;
var_dump($wpdb->queries);  // 모든 실행된 쿼리 확인
Xdebug 연동 (고급)
로컬 개발 환경(Local by Flywheel, XAMPP 등)에서 PHP Xdebug를 PHPStorm 또는 VS Code와 연동하면 브레이크포인트를 설정하여 코드를 단계별로 실행하며 디버그할

            수 있습니다. 카페24 등 공유 호스팅에서는 직접 사용이 제한적입니다.
디버그 전용 플러그인 목록

Query Monitor: 가장 강력한 무료 디버그 플러그인
Debug Bar: 관리자 바에 디버그 정보 추가
WP Crontrol: WordPress cron 작업 모니터링
Health Check & Troubleshooting: 관리자만 디버그 모드 적용 가능

10. 자주 묻는 질문 (FAQ)
Q. WP_DEBUG를 활성화해도 debug.log 파일이 생성되지 않아요.
WP_DEBUG_LOG를 true로 설정했는지 확인하고, wp-content 폴더에 쓰기 권한(755)이 있는지 확인하시기 바랍니다. 또는

            wp-content 폴더 안에 빈 debug.log 파일을 미리 만들고 권한을 644로 설정하면 됩니다.
Q. 디버그가 끝난 후 WP_DEBUG를 다시 끄는 방법은?
wp-config.php에서 define('WP_DEBUG', true)를 define('WP_DEBUG', false)로

            변경하면 됩니다. 운영 환경에서는 반드시 디버그 모드를 비활성화해야 합니다. WP_DEBUG_DISPLAY를 false로 유지하면 화면에 오류

            메시지가 노출되지 않습니다.
Q. Query Monitor와 Debug Bar 중 어느 것을 사용해야 하나요?
Query Monitor를 권장합니다. Debug Bar보다 훨씬 많은 정보(DB 쿼리, 훅, REST API, 블록 에디터 데이터 등)를 제공하며 인터페이스가 더 직관적입니다. 두 플러그인 모두

            무료로 사용할 수 있습니다.
Q. 운영 중인 사이트에서 디버그 모드를 켜도 되나요?
WP_DEBUG_DISPLAY를 반드시 false로 설정한 상태에서만 켜시기 바랍니다. 이 설정을 지키면 방문자 화면에 오류 메시지가 노출되지 않고

            debug.log에만 기록됩니다. 디버그 완료 후에는 WP_DEBUG를 false로 되돌리는 것을 잊지 마시기 바랍니다.
        
Q. debug.log 파일이 너무 커져서 관리가 어려워요.
디버그 작업 후 WP_DEBUG를 다시 false로 변경하고 debug.log 파일을 삭제하면 됩니다. 또는 WP

            Crontrol 플러그인으로 정기적으로 로그 파일을 정리하도록 설정할 수 있습니다.
정리 — 워드프레스 디버그, 이렇게 진행하세요
워드프레스 디버그의 기본 순서는 아래와 같습니다.

WP_DEBUG 활성화 → debug.log에서 Fatal error 확인
오류 메시지의 파일 경로로 원인 플러그인/테마 파악
해당 플러그인/테마 비활성화로 확인
결원이 특정되지 않으면 이분 탐색법으로 플러그인 범위 좁히기
Query Monitor로 DB 쿼리·성능 문제 추가 점검
브라우저 DevTools Console로 JS 오류 확인
해결 후 WP_DEBUG 비활성화

에러 코드별 구체적인 해결 방법은 아래 가이드를 참고하시기 바랍니다.

워드프레스 에러 해결 완벽 가이드 (전체 에러 총정리)
워드프레스 PHP Fatal Error 해결 가이드
워드프레스 500 Internal Server

                    Error 해결 가이드

]]>