🚨 워드프레스 설치 중 발생하는 오류 해결법 모음 (초보자 필수 가이드)

🚨 워드프레스 설치 중 발생하는 오류 해결법 모음 (초보자 필수 가이드)

워드프레스를 로컬 서버에 설치하다 보면
처음엔 쉬워 보이다가도 갑자기 오류 메시지가 뜨고 당황하게 되는 경우가 많습니다.

• “데이터베이스 연결 실패”
• “페이지를 찾을 수 없습니다”
• “파일 권한 오류” 등…

이 글에서는 초보자들이 가장 많이 겪는 설치 오류 7가지를 정리하고,
각각의 해결 방법을 단계별로 안내해 드릴게요.

 

---

✅ 1. 오류: 데이터베이스 연결 실패 (Error establishing a database connection)

🔍 원인:

• wp-config.php 파일 내 DB명, 사용자명, 비밀번호 오타
• MySQL 서버가 꺼져 있음
• DB가 실제로 존재하지 않음

🛠 해결 방법:

1. MySQL 서버 실행 확인 (XAMPP, MAMP → MySQL Start)
2. phpMyAdmin에서 데이터베이스가 실제로 존재하는지 확인
3. wp-config.php에서 정보 확인:

php

복사편집

define('DB_NAME', 'myblog_db'); define('DB_USER', 'root'); define('DB_PASSWORD', ''); define('DB_HOST', 'localhost');

---

✅ 2. 오류: 404 페이지 / 설치 마법사 진입 안 됨

🔍 원인:

• 워드프레스 폴더 경로가 잘못되었거나
• 브라우저 주소 입력 오류
• htdocs 폴더에 올바르게 넣지 않음

🛠 해결 방법:

• 폴더 경로 재확인: C:\xampp\htdocs\myblog
• 주소창: http://localhost/myblog 정확히 입력
• 압축 해제한 워드프레스 파일이 한 단계 더 안에 폴더로 들어가 있지는 않은지 확인

---

✅ 3. 오류: "Cannot connect: invalid settings" in phpMyAdmin

🔍 원인:

• 사용자명 또는 비밀번호가 틀림
• MySQL이 꺼져 있음
• 포트 충돌

🛠 해결 방법:

• 기본 사용자: root / 비밀번호: XAMPP(빈칸), MAMP(root)
• MySQL 실행 확인
• 포트 번호 충돌 시 XAMPP 설정에서 config > my.ini에서 포트 변경 확인

---

✅ 4. 오류: 브라우저에서 "localhost 작동 안 함" 또는 연결 오류

🔍 원인:

• Apache 서버 실행 안 됨
• 방화벽 또는 백신 프로그램 차단

🛠 해결 방법:

• XAMPP, MAMP에서 Apache가 실행 중인지 확인
• 방화벽에서 Apache HTTP Server 예외 처리
• 포트 80 충돌 시 → httpd.conf에서 포트 변경:

apache

복사편집

Listen 8080 ServerName localhost:8080

이후 주소창 입력도 http://localhost:8080으로 변경

---

✅ 5. 오류: wp-config.php 파일이 없음

🔍 원인:

• 파일이 생성되지 않았거나
• 수동 설치 시 복사 안 함

🛠 해결 방법:

• wp-config-sample.php 파일을 복사 → wp-config.php로 이름 변경
• 수동으로 정보 입력하거나 설치 마법사 통해 자동 생성

---

✅ 6. 오류: 페이지 하얗게 나옴 (White Screen of Death)

🔍 원인:

• PHP 메모리 부족
• 테마 또는 플러그인 오류
• 잘못된 코드 삽입

🛠 해결 방법:

• php.ini에서 메모리 한도 늘리기:

ini

복사편집

memory_limit = 256M

• 테마 변경: /wp-content/themes에 기본 테마로 교체
• 플러그인 비활성화: /wp-content/plugins 폴더명을 임시로 plugins_old로 변경

---

✅ 7. 오류: 사이트 언어 선택 화면에서 멈춤

🔍 원인:

• 파일 권한 문제
• wp-config 생성 권한 없음

🛠 해결 방법:

• 해당 폴더에 관리자 권한 부여
• 수동으로 wp-config.php 작성
• PHP 오류 로그 확인: C:\xampp\php\logs 또는 MAMP의 logs/php_error.log

---

🧩 추가 팁: 오류 대처 체크리스트

항목확인 포인트

서버 실행 상태	Apache, MySQL 모두 ON인지
DB 설정	DB명, 사용자명, 비밀번호 정확한지
포트	80, 3306, 8080 등 충돌 여부
폴더 구조	워드프레스 파일 위치 정확한지
캐시 문제	브라우저 캐시 삭제 후 재접속

---

✅ 요약 정리

오류주요 원인해결 팁

DB 연결 실패	wp-config 설정 오류	DB 정보 확인, MySQL 실행
설치 진입 불가	경로 문제	폴더 위치 및 브라우저 주소 재확인
phpMyAdmin 오류	인증 실패	기본 사용자명/비번 재확인
백화면	메모리 부족, 테마 오류	PHP 설정 수정, 테마/플러그인 리셋

---

📘 다음 글 예고

👉 워드프레스 한글 설정 및 기본 옵션 조정하기
: 설치 후 가장 먼저 해야 할 일! 사이트 언어, 시간대, 글쓰기 방식 등 필수 초기 설정을 함께 알아보겠습니다.