Source: Dev.to

워드프레스 사이트가 다운됐을 때 해야 할 일 – 단계별 가이드

워드프레스 사이트가 갑자기 접근이 안 된다면 당황하기 쉽습니다. 하지만 차근차근 문제를 진단하면 대부분 빠르게 복구할 수 있습니다. 아래 단계들을 따라가며 원인을 찾아보세요.

---

1️⃣ 사이트가 정말 다운됐는지 확인하기

• 다른 기기/네트워크에서 사이트에 접속해 보세요.
• Down For Everyone Or Just Me(https://downforeveryoneorjustme.com/) 같은 서비스를 이용해 전 세계적으로 접속이 안 되는지 확인합니다.
• 만약 내부 네트워크만 문제라면 로컬 DNS 캐시를 비우거나 라우터를 재시작해 보세요.

2️⃣ 호스팅 제공업체 상태 확인

• 호스팅 대시보드에 로그인해 서버 상태나 알림을 확인합니다.
• 호스팅 업체의 시스템 상태 페이지(예: AWS Service Health, Cloudflare Status)에서 현재 장애가 보고됐는지 확인합니다.
• 문제가 확인되면 지원 티켓을 열어 상황을 문의합니다.

3️⃣ 오류 로그 확인

• cPanel → Metrics → Errors 혹은 Plesk → Logs에서 최신 오류 로그를 확인합니다.
• wp-content/debug.log (디버그 모드가 켜져 있다면) 혹은 서버의 error_log 파일을 살펴봅니다.
• 흔히 보이는 오류 예시:
  • Fatal error: Uncaught Error: Call to undefined function...
  • Memory exhausted...
  • 500 Internal Server Error

4️⃣ 플러그인 비활성화

플러그인 충돌이 가장 흔한 원인 중 하나입니다.

# FTP 또는 파일 매니저를 사용해 플러그인 폴더 이름을 바꾸기
wp-content/plugins → wp-content/plugins-deactivated

• 사이트가 정상적으로 복구되면 플러그인 폴더를 원래 이름으로 되돌리고, 하나씩 다시 활성화하면서 문제를 일으키는 플러그인을 찾습니다.

5️⃣ 기본 테마로 전환

테마 파일에 오류가 있을 경우도 있습니다.

• wp-content/themes 폴더 안에 있는 현재 테마 폴더 이름을 임시로 바꿉니다.
• 워드프레스는 자동으로 Twenty Twenty‑Three 같은 기본 테마로 전환합니다.
• 기본 테마에서도 문제가 지속된다면 테마가 원인일 가능성은 낮습니다.

6️⃣ .htaccess 파일 점검

잘못된 리다이렉트나 규칙이 사이트를 차단할 수 있습니다.

1. 백업 후 .htaccess 파일을 삭제하거나 이름을 바꿉니다.
2. 워드프레스 관리자 → 설정 → 고정 링크 페이지에 들어가 “변경 사항 저장”을 클릭해 새로운 .htaccess를 자동 생성합니다.
3. 필요에 따라 커스텀 규칙을 하나씩 다시 추가해 보세요.

7️⃣ 워드프레스 코어 파일 재설치

코어 파일이 손상되었을 경우:

• 대시보드 → 업데이트 페이지에서 “재설치” 버튼을 클릭합니다.
• 혹은 최신 워드프레스 ZIP 파일을 다운로드 받아 wp-admin과 wp-includes 폴더를 덮어쓰기합니다. (데이터베이스와 wp-content는 건드리지 않음)

8️⃣ PHP 버전 및 메모리 제한 확인

• 호스팅 대시보드에서 PHP 버전이 워드프레스 요구 사항(현재는 PHP 8.0 이상)과 일치하는지 확인합니다.
• php.ini 혹은 .htaccess에 memory_limit을 256M 이상으로 설정해 보세요.

9️⃣ 데이터베이스 연결 오류 해결

• wp-config.php 파일에서 DB_NAME, DB_USER, DB_PASSWORD, DB_HOST 값이 정확한지 검토합니다.
• 호스팅 제공업체가 제공하는 phpMyAdmin에서 데이터베이스가 정상인지 확인하고, 필요하면 복구 옵션을 실행합니다.

🔟 최종 점검 및 백업

• 모든 문제를 해결한 뒤 사이트 전체 테스트(프론트엔드, 관리자 페이지, 주요 플러그인 기능) 를 진행합니다.
• 정상 작동이 확인되면 전체 백업(파일 + 데이터베이스)을 최신 버전으로 저장해 두세요.
• 앞으로 비슷한 상황에 대비해 모니터링 툴(UptimeRobot, Pingdom 등)과 자동 백업 플러그인(UpdraftPlus, BlogVault 등)을 설정하는 것을 권장합니다.

---

📌 요약

위 순서를 차례대로 진행하면 대부분의 다운 상황을 빠르게 진단하고 복구할 수 있습니다. 문제가 지속되면 호스팅 제공업체나 워드프레스 전문가에게 추가 지원을 요청하세요. 🚀

초기 점검

1. 다른 기기나 네트워크에서 확인 – ISP 또는 DNS 캐시 문제를 배제합니다.

2. 시크릿/프라이빗 모드 사용 – 브라우저 캐시 문제를 제거합니다.

3. 호스트 상태 페이지 방문 – 서버 자체가 다운됐을 수 있습니다.

4. curl 요청 실행하여 원시 HTTP 응답을 확인합니다:

   curl -I https://yoursite.com

   • 200 OK인데 사이트가 깨져 보이면 → 테마나 프런트엔드 문제일 가능성이 높습니다.
   • 500 / 502 / 503 → 아래 트러블슈팅 단계로 진행합니다.

Source: …

오류 로그 접근하기

SSH 사용 시

# Apache
tail -50 /var/log/apache2/error.log

# Nginx
tail -50 /var/log/nginx/error.log

# WordPress‑specific
tail -50 /var/www/yoursite/wp-content/debug.log

SSH 없이

호스팅 제어판(cPanel, Plesk 또는 호스트의 맞춤 대시보드)에서 오류 로그 섹션을 확인합니다.

로그는 보통 문제를 직접 가리키며, 예시:

• PHP Fatal error: Allowed memory size exhausted → 메모리 제한
• PHP Fatal error: Cannot redeclare function → 플러그인 충돌
• Error establishing a database connection → 데이터베이스 문제
• PHP Parse error: syntax error → 파일 손상

일반적인 오류 및 해결 방법

플러그인 문제 해결

플러그인 폴더 이름 바꾸기 (SSH/FTP)

cd /var/www/yoursite/wp-content
mv plugins plugins_disabled
mkdir plugins

• 사이트를 새로 고칩니다. 정상 작동한다면 플러그인 때문에 충돌이 발생한 것입니다.

• 원래 폴더를 복원하고 wp‑admin 또는 WP‑CLI를 통해 플러그인을 하나씩 다시 활성화합니다:

  # Deactivate all plugins
  wp plugin deactivate --all
  
  # Reactivate individually
  wp plugin activate plugin-name

이름을 바꿔도 문제가 해결되지 않을 경우

1. wp-config.php 파일을 열어 구문 오류(세미콜론 누락, 따옴표 미닫힘 등)를 확인합니다.
2. 데이터베이스 자격 증명을 확인합니다 – 변경되었을 수 있습니다.
3. 파일에 최근에 수정한 내용을 확인합니다; 다른 환경에서 설정을 복사할 때 호스트, 데이터베이스 이름, 비밀번호 등을 업데이트하는 것을 놓치는 경우가 많습니다.

Database Connection Issues

# Verify MySQL is running
mysqladmin -u root -p status

# Test credentials
mysql -u wp_user -p wp_database

• Check disk space (MySQL can’t write if the disk is full):

  df -h

• Repair tables (temporary line in wp-config.php):

  define('WP_ALLOW_REPAIR', true);

  Visit https://yoursite.com/wp-admin/maint/repair.php, run the repair, then remove the line from wp-config.php.

메모리 부족

wp-config.php에 다음 상수를 추가(또는 증가)하십시오:

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

문제가 지속되면 플러그인이나 테마가 과도한 메모리를 사용하고 있는 것입니다; 메모리 증가는 일시적인 해결책에 불과합니다.

테마 문제 해결

• WP‑CLI를 사용하여 기본 테마로 전환:

  wp theme activate twentytwentyfour

• 또는 FTP를 통해 활성 테마 폴더 이름을 변경하세요; 워드프레스가 자동으로 기본 테마로 돌아갑니다.

파일 권한

잘못된 권한은 종종 500 오류를 일으킵니다. 표준 WordPress 권한을 적용하세요:

# Directories
find /var/www/yoursite -type d -exec chmod 755 {} \;

# Files
find /var/www/yoursite -type f -exec chmod 644 {} \;

# wp-config.php (more restrictive)
chmod 600 wp-config.php

핵심 파일 손상

wp-content를 건드리지 않고 WordPress 핵심 파일을 다시 다운로드합니다:

wp core download --force --skip-content

이렇게 하면 손상된 핵심 파일을 안전하게 교체하고, 업데이트 실패나 악성코드로 인한 문제를 해결합니다.

전문가 도움을 받아야 할 때

시간이 촉박할 때(예: 몇 시간 안에 클라이언트 회의가 잡힌 새벽 2시 정전 상황) 플러그인을 체계적으로 테스트할 수 없다면, Fix‑WP와 같은 서비스가 일회성 요금으로 한 시간 이내에 사이트를 진단하고 복구할 수 있습니다.

구독도, 유지비도 없습니다—백업과 수정, 그리고 에스크로 보관 결제만 제공됩니다.

예방 팁

• 플러그인을 최신 상태로 유지하되, 업데이트는 먼저 스테이징 사이트에서 테스트합니다.
• 플러그인 수를 제한 – 각각이 잠재적인 실패 지점을 추가합니다.
• 데이터베이스 상태를 모니터링 – 자동 로드 팽창 및 느린 쿼리를 주시합니다.
• wp-config.php를 수동으로 편집하는 대신 구성 관리자를 사용합니다.
• 백업 자동화 – 매일, 테스트된, 서버 외부에 저장합니다.

WP Multitool (평생 $50)은 데이터베이스 상태, 느린 쿼리 감지, 자동 로드 분석 및 프런트엔드 최적화를 위한 모니터링 모듈을 제공하며, 비활성화 시 오버헤드가 없습니다.