데이터베이스 연결 설정 오류, 왜 안 되냐고요? 해결법 알려드릴게요!
웹사이트를 테스트하거나 로컬 서버를 돌리다가 "Error Establishing a Database Connection"라는 메시지를 만난 적 있나요? 저는 처음 이거 봤을 때 "뭐야, 데이터베이스가 어디 갔어?" 하면서 당황했었어요. 주로 MySQL이나 WordPress 같은 걸 쓸 때 뜨는 이 오류, 사실 몇 가지 확인만 하면 해결할 수 있답니다. 오늘은 그 방법을 쉽게 풀어드릴게요!
이 오류가 뜨는 이유는 뭘까?
간단히 말하면, 프로그램이 데이터베이스에 연결을 못하는 거예요. 원인은 보통 이런 것들 때문이에요.
● 잘못된 설정: 데이터베이스 이름, 사용자 이름, 비밀번호 등이 틀렸을 때.
● 서버 꺼짐: MySQL 같은 데이터베이스 서버가 실행 중이 아닐 때.
● 파일 손상: 설정 파일이나 데이터베이스 자체가 망가졌을 때.
● 리소스 부족: 메모리나 CPU가 모자랄 때.
그럼 하나씩 해결해 볼까요?
◆ 해결법 1: 데이터베이스 정보 확인하기
가장 흔한 원인은 설정 파일에 입력한 정보가 잘못된 경우예요. WordPress를 예로 들면
▶ wp-config.php 파일 열기(보통 웹사이트 루트 폴더에 있어요).
▶ 아래 부분 확인:
define('DB_NAME', '데이터베이스 이름');
define('DB_USER', '사용자 이름');
define('DB_PASSWORD', '비밀번호');
define('DB_HOST', 'localhost'); // 보통은 localhost지만, 서버마다 다를 수 있어요.
▶ 이 정보가 실제 데이터베이스와 똑같은지 확인하세요. 저는 비밀번호 한 글자 틀려서 한참 헤맸던 적 있어요!
◆ 해결법 2: 데이터베이스 서버 실행 확인
MySQL 같은 서버가 꺼져 있으면 연결이 안 되죠.
▶ 윈도우라면 "서비스" 열기: Win + R 누르고 services.msc 입력.
▶ "MySQL"이나 "MariaDB" 찾고, "실행 중"인지 확인. 꺼져 있으면 우클릭 > "시작" 눌러보세요.
▶ XAMPP나 WAMP 쓰고 있다면, 컨트롤 패널에서 MySQL 모듈을 켜놓았는지 체크!
◆ 해결법 3: 데이터베이스 상태 점검
데이터베이스 자체가 손상됐을 수도 있어요.
▶ phpMyAdmin 같은 툴로 접속해보세요(보통 http://localhost/phpmyadmin).
▶ 접속 안 되면 MySQL 명령어로 확인:
▷▷ 명령 프롬프트 열고 mysql -u root -p 입력 > 비밀번호 입력.
▷▷ SHOW DATABASES; 입력해서 데이터베이스 목록이 뜨는지 확인.
▶ 테이블 손상됐으면 phpMyAdmin에서 "Repair Table" 눌러보세요.
◆ 해결법 4: 호스팅 서버 문제라면?
로컬이 아니라 호스팅 업체 서버에서 오류가 난 거라면
▶ 서버 상태 확인: 업체 공지사항이나 지원팀에 문의.
▶ DB_HOST 값 확인: "localhost"가 아니라 업체가 제공한 주소일 수 있어요(예: mysql.example.com).
◆ 해결법 5: 로그 확인으로 디버깅
그래도 안 되면 로그를 봐야 해요.
▶ WordPress라면 wp-config.php에 이 코드 추가:
define('WP_DEBUG', true);
define('WP_DEBUG_LOG', true);
▶ 그러면 wp-content/debug.log 파일에 오류 메시지가 쌓여요. 저는 이걸로 "비밀번호 오류" 찾았던 적 있답니다!
◆ 해결법 6: 최후의 수단, 재설치
설정 다 맞는데도 안 되면
▶ 데이터베이스 백업 후 새로 만들기.
▶ WordPress면 wp-config.php 새로 설정해서 연결.
※팁: 미리 막으려면?
설정 바꾸기 전에 백업 꼭 하세요.
비밀번호나 이름은 복사 붙여넣기로 실수 줄이기.
서버 리소스 체크 자주 해주세요.
이 오류는 처음 보면 복잡해 보이지만, 하나씩 점검하면 금방 해결돼요. 저도 로컬에서 WordPress 테스트하다가 몇 번 겪었는데, 이제는 "아, 또 너구나" 싶더라고요. 여러분도 이 방법 따라 해보시고, 질문 있으면 댓글로 남겨주세요! 다음엔 또 다른 윈도우 오류로 찾아올게요!
댓글