Spaceship Hosting에서 WordPress의 “데이터베이스 연결 오류”를 해결하는 방법

에 업데이트됨

"데이터베이스 연결을 설정하는 중 오류가 발생했습니다" 메시지는 WordPress에서 웹사이트가 데이터베이스에 연결할 수 없음을 의미합니다. 대부분의 경우, 이는 WordPress 구성 파일에 잘못된 데이터베이스 접근 정보가 입력되어 있을 때 발생합니다:



이 가이드에서는 이 오류의 가장 일반적인 원인을(를) 다루고, 이를 해결하는 단계별 방법을 안내합니다.

이 오류의 원인은 무엇인가요?

대부분의 경우, "데이터베이스 연결을 설정하는 중 오류가 발생했습니다" 오류는 WordPress에서 잘못된 데이터베이스 접근 정보를 사용할 때 발생합니다. 이는 다음과 같은 상황 이후에 자주 발생합니다:

  • 웹사이트를 새 호스팅 제공업체로 이전

  • 데이터베이스 비밀번호 변경

  • 백업 복원

  • 구성 파일 수동 편집

  • 서버 또는 호스팅 플랜 간 파일 이동

데이터베이스 연결 정보 확인

WordPress는 데이터베이스 이름, 데이터베이스 사용자 이름, 비밀번호, 데이터베이스 호스트, 그리고 데이터베이스 사용자에게 할당된 접근 권한을(를) 사용하여 데이터베이스에 연결합니다.

따라서 다음 조건들이 모두 충족되는지 확인해야 합니다:

  • 서버에 데이터베이스 이름이 존재하며, 기존 데이터베이스 이름과 일치해야 합니다

  • 데이터베이스 사용자 이름이 기존 데이터베이스 사용자와 일치해야 합니다

  • 비밀번호가 해당 사용자에 대해 올바른지 확인하세요

  • 데이터베이스 사용자가 데이터베이스에 할당되어 있는지

  • 사용자에게 전체 접근 권한(ALL PRIVILEGES)이 부여되어 있는지 확인하세요

데이터베이스 정보를 어떻게 확인하나요?

모든 데이터베이스 연결 정보는 wp-config.php 파일에 저장되어 있으며, 이 파일은 WordPress 설치의 루트 디렉터리에 있습니다. 정보를 확인하려면 다음을 수행하세요:

  1. cPanel에 로그인한 후 파일 관리자로 이동하세요:


  2. WordPress 루트 디렉터리로 이동하여 wp-config.php 파일을 엽니다(편집 또는 보기 옵션 사용):




    참고: 편집을 선택할 때는 wp-config.php 파일의 백업을 생성하는 것이 좋습니다:


  3. 데이터베이스 이름, 사용자, 비밀번호가 포함된 다음 줄을 찾으세요:


  4. 다른 탭에서 내 데이터베이스 관리 메뉴를 여세요:




  5. 데이터베이스 이름과 사용자가 wp-config.php에 지정된 것과 일치하는지 주의 깊게 확인하세요:


  6. 아래로 스크롤하여 데이터베이스 사용자가 실제로 서버에 존재하는지 확인하세요:



  7. 데이터베이스 사용자에 대해 설정된 비밀번호를 확인할 수 없으므로, 비밀번호 변경을 클릭하여 새로 설정해야 합니다:



  8. 업데이트 필요하다면 wp-config.php의 값을 수정하세요.

  9. 올바른 데이터베이스 사용자가 데이터베이스에 할당되어 있고 전체 권한이 활성화되어 있는지 확인하세요(사용자 클릭 >> 전체 권한 체크 >> 변경 적용):




  10. 웹사이트를 새로고침하세요! 자격 증명이 올바르면 웹사이트가 정상적으로 로드됩니다.

아직도 이 오류가 보이나요?

데이터베이스 자격 증명이 올바른데도 오류가 계속된다면, 문제는 다음과 같은 원인일 수 있습니다:

  • 손상된 데이터베이스

  • 일시적인 MySQL 서버 장애

  • 손상된 WordPress 핵심 파일

이 단계에서는 지원팀에 문의하셔서 데이터베이스 서비스 상태와 로그를 확인받으시기 바랍니다.

유효한 이메일이 필요합니다