WordPress에서 데이터베이스 연결 설정 오류를 해결하는 7단계

게시 됨: 2024-04-08

WordPress에서 "데이터베이스 연결 설정 오류"에 문제가 있습니까? 이 문제를 신속하게 해결하고 사이트를 다시 운영할 수 있는 방법을 알려 드리겠습니다.

이 오류를 효과적으로 진단하고 해결하기 위한 몇 가지 문제 해결 단계가 있습니다. 다음 단계를 따르면 콘텐츠나 데이터 손실 없이 사이트가 정상 작동 상태로 돌아갈 수 있습니다.

먼저 WordPress에서 "데이터베이스 연결 설정 오류"가 표시되는 몇 가지 일반적인 이유를 설명하겠습니다. 다음으로, 이러한 잠재적인 원인을 해결하기 위한 각 단계를 안내하여 사이트 기능을 복원하는 데 도움을 드리겠습니다.

WordPress에서 데이터베이스 연결을 설정하는 중 오류가 발생했습니다.
목차

WordPress에서 데이터베이스 연결 설정 오류의 원인은 무엇입니까?

WordPress가 작동하려면 웹 서버와 데이터베이스가 모두 필요합니다. 웹 서버는 미디어 파일과 같이 WordPress 사이트를 실행하는 데 필요한 PHP 파일 및 기타 파일을 호스팅합니다. 데이터베이스에는 모든 게시물 및 페이지 정보와 사이트 구성 세부 정보가 들어 있습니다. 사용자가 페이지를 보러 가면 PHP는 데이터베이스에서 해당 페이지에 대한 데이터를 가져옵니다. 어떤 이유로든 이 연결이 끊어지면 데이터베이스 연결 오류가 발생합니다.

WordPress에서 데이터베이스 연결 설정 중 오류가 발생하는 몇 가지 일반적인 원인은 다음과 같습니다.

  • 잘못된 로그인 자격 증명 – 잘못된 데이터베이스 로그인 자격 증명은 데이터베이스 연결 오류의 가장 일반적인 원인입니다. 이는 일반적으로 WordPress 사이트를 새 호스트로 이동한 직후에 메시지가 표시되는 경우에 발생합니다.
  • 불충분한 사용자 권한 – 올바른 사용자 이름/비밀번호가 있지만 사용자에게 적절한 권한이 없을 수 있습니다. 다시 말하지만, 사이트를 마이그레이션한 후 오류가 발생하는 경우 이는 더 일반적입니다.
  • 데이터베이스 손상 – 이는 MySQL 데이터베이스를 직접 조작하여 발생할 수 있지만 플러그인 설치 또는 삭제 등으로 인해 실수로 발생할 수도 있습니다.
  • 파일 손상 – 데이터베이스 자체와 마찬가지로 손상된 파일로 인해 WordPress에서 데이터베이스 연결 설정 오류가 발생할 수도 있습니다.
  • 데이터베이스 서버 문제 – 웹 호스트가 별도의 데이터베이스 서버를 사용하는 경우 해당 서버의 문제로 인해 사이트 파일을 호스팅하는 서버가 제대로 작동하더라도 WordPress에서 데이터베이스 연결 설정 오류 메시지가 발생할 수 있습니다.
  • 갑작스러운 트래픽 증가 - 트래픽이 갑자기 급증하면 사이트가 동시 데이터베이스 연결 증가에 대처하는 데 어려움을 겪으면서 이 데이터베이스 오류가 발생할 수 있습니다. 귀하의 사이트가 공유 호스팅을 사용하는 경우 발생할 가능성이 더 높습니다.

다시 말하지만, 사이트를 새 호스트로 마이그레이션한 후 오류가 발생하는 경우 처음 두 가지 문제가 가장 일반적입니다. 다른 문제는 모든 사이트에서 발생할 수 있습니다.

WordPress에서 데이터베이스 연결 설정 오류를 해결하는 방법

이제 잠재적인 원인이 무엇인지 알았으니 이제 문제를 해결할 차례입니다. 데이터베이스 연결 문제를 해결하고 사이트를 다시 온라인 상태로 만들려면 이 단계별 가이드를 따르세요.

좋은 출발점은 사이트를 백업하는 것입니다. 문제를 해결하면서 사이트가 더 이상 손상되는 위험을 감수하고 싶지 않습니다. 백업을 갖는 것은 이러한 일이 발생하는 것에 대비한 합리적인 보호 장치입니다. 파일과 데이터베이스를 모두 백업했는지 확인하세요.

wp-config.php에서 데이터베이스 로그인 자격 증명을 확인하세요.

첫 번째 호출 포트는 wp-config.php 파일이어야 하며, 이 파일은 public_html , htdocs 또는 www 라는 사이트 디렉토리에서 찾을 수 있습니다. FTP 클라이언트를 사용하여 다운로드하세요.

또는 호스트가 cPanel을 제공하는 경우 대시보드에서 파일 관리자 아이콘을 찾아 해당 폴더로 이동하세요.

cPanel 파일 관리자

wp-config.php 파일을 다운로드하여 안전하게 보관하세요. 이 버전을 백업 복사본으로 원할 것입니다.

cPanel 파일 관리자에서 wp-config.php를 다운로드하세요.

다음으로, wp-config.php 에서 다음 코드 줄을 찾으세요.

 // ** Database settings - You can get this info from your web host ** // /** The name of the database for WordPress */ define( 'DB_NAME', 'database_name_here' ); /** Database username */ define( 'DB_USER', 'username_here' ); /** Database password */ define( 'DB_PASSWORD', 'password_here' ); /** Database hostname */ define( 'DB_HOST', 'localhost' ); /** Database charset to use in creating database tables. */ define( 'DB_CHARSET', 'utf8' ); /** The database collate type. Don't change this if in doubt. */ define( 'DB_COLLATE', '' );

위의 예는 샘플 데이터를 보여줍니다. 나열된 처음 4개 설정(데이터베이스 이름, 데이터베이스 사용자 이름, 데이터베이스 비밀번호 및 데이터베이스 호스트 이름)의 경우 호스트에서 제공한 정보가 있어야 합니다. WordPress를 수동으로 설치한 경우 처음 세 가지 자격 증명을 직접 정의했을 수 있습니다.

데이터베이스 이름, 데이터베이스 사용자 이름, 데이터베이스 비밀번호 및 데이터베이스 호스트 이름을 확인하여 보유한 정보가 올바른지 확인할 수 있습니다. cPanel 사용자인 경우 cPanel의 데이터베이스 섹션에서 관련 정보를 찾을 수 있습니다.

cPanel 데이터베이스

데이터베이스 이름을 확인하세요.

데이터베이스 이름을 확인하려면 phpMyAdmin 으로 이동하여 화면 왼쪽에서 찾아보세요. wp-config.php 의 데이터베이스 이름과 일치해야 합니다.

데이터베이스 이름을 표시하는 phpMyAdmin
데이터베이스 이름을 표시하는 wp-config.php

데이터베이스 이름을 클릭한 다음 wp_options 테이블(귀하의 접두어는 다를 수 있음)을 클릭하여 올바른 웹사이트인지 다시 확인하세요. 사이트 URL과 홈페이지를 찾으세요. 여기에는 귀하의 웹사이트 URL이 표시되어야 합니다.

wp_options 사이트 URL 및 홈

사용자 이름과 비밀번호를 확인하세요

데이터베이스 이름이 확인되면 서버에서 간단한 PHP 스크립트를 실행하여 wp-config.php 의 사용자 이름과 비밀번호가 올바른지 테스트할 수 있습니다.

메모장과 같은 텍스트 편집기에 다음 코드를 입력하고 testconnect.php 로 저장합니다.

 <?php $link = mysql_connect('localhost', 'username', 'password'); if (!$link) { die('Could not connect: ' . mysql_error()); } echo 'Connected to database'; mysql_close($link); ?>

스크립트에 사용자 이름과 비밀번호가 표시된 경우 이를 데이터베이스 사용자 및 비밀번호에 대한 wp-config.php 의 값으로 바꾸세요.

이 스크립트를 웹 호스팅의 public_html , htdocs 또는 www 디렉토리에 업로드하세요(정확한 스크립트는 호스트에 따라 다름).

yourdomainname.com/testconnect.php 로 이동하여 스크립트를 실행하세요. 성공 메시지를 받으면 사용자 이름과 비밀번호가 올바른 것입니다.

오류가 발생하면 데이터베이스 사용자의 비밀번호를 재설정하거나 새 데이터베이스 사용자 및 비밀번호를 생성해야 합니다.

cPanel의 MySQL Databases 아래에서 데이터베이스 사용자를 찾을 수 있습니다.

cPanel MySQL 데이터베이스

데이터베이스 사용자의 비밀번호를 변경하려면 현재 사용자를 찾아 업데이트하려는 사용자에 대한 비밀번호 변경 옵션을 선택하세요. 완료되면 비밀번호 변경 버튼을 사용하세요.

데이터베이스 현재 사용자 비밀번호 변경

또는 새 사용자 추가 양식을 작성하여 새 사용자를 추가할 수 있습니다.

MySQL 사용자 새 사용자 추가

사용자를 생성한 후 드롭다운 컨트롤에서 선택하고 추가 를 사용하여 해당 사용자를 데이터베이스에 추가합니다.

데이터베이스에 사용자 추가

그러면 사용자 권한 관리 화면이 표시됩니다. 모든 권한을 확인한 다음 변경합니다 .

MySQL은 사용자 권한을 관리합니다.

wp-config.php 업데이트하고 비밀번호 및/또는 사용자와 함께 저장하는 것을 잊지 마세요. 서버에서 testconnect.php 삭제할 수도 있습니다.

데이터베이스 호스트 이름을 확인하세요

데이터베이스, 사용자 및 비밀번호를 확인한 후에도 여전히 연결 오류가 발생하는 경우 데이터베이스 호스트 이름을 확인하세요. 데이터베이스 호스트 이름은 일반적으로 localhost 이지만 일부 호스트는 127.0.0.1 사용할 수 있습니다. 둘 다 효과가 없다면 호스트에게 문의하여 올바른 값을 알아보세요.

데이터베이스 사용자 권한 확인

자격 증명을 확인한 후에도 여전히 오류 메시지가 나타나면 데이터베이스 사용자에게 올바른 권한이 있는지 확인할 수 있습니다. 데이터베이스 사용자를 직접 생성한 경우 실수로 해당 사용자에게 충분한 권한을 부여했을 수 있습니다.

cPanel에서 MySQL Databases 로 이동한 다음 Current Databases로 이동합니다. 권한 있는 사용자를 찾아 확인하려는 사용자를 클릭합니다.

현재 데이터베이스 권한이 있는 사용자

어떤 권한이 확인되었는지 확인하고 모든 권한이 활성화되어 있는지 확인하세요. 모든 권한을 저장하려면 변경 만들기를 사용하세요. 그런 다음 사이트에 다시 액세스해 보세요.

데이터베이스 사용자에 대한 권한이 부족합니다.

데이터베이스 복구

데이터베이스 로그인 자격 증명과 데이터베이스 사용자 권한을 확인한 경우 다음 단계는 데이터베이스 복구를 시도하는 것입니다. "하나 이상의 데이터베이스 테이블을 사용할 수 없습니다."라는 메시지가 나타나면 이 작업을 수행해야 할 수도 있습니다. 데이터베이스를 복구해야 할 수도 있습니다.” wp-admin 에서 .

wp-config.php 끝에 다음 줄을 추가하여 복구 모드에 액세스할 수 있습니다.

 define('WP_ALLOW_REPAIR', true);

wp-config.php 편집하고 업데이트된 wp-config.php 파일을 저장하거나 웹 공간에 업로드하세요.

그런 다음 yourdomainname.com/wp-admin/maint/repair.php 방문하세요.

두 가지 옵션이 제공됩니다. 하나는 데이터베이스를 복구하는 것이고 다른 하나는 데이터베이스를 복구하고 최적화하는 것입니다. 두 번째는 시간이 더 걸립니다.

WordPress 복구 데이터베이스

사용하고 싶은 것을 선택하고, 완료되면 웹사이트에서 연결 오류가 해결되었는지 다시 확인하세요.

워드프레스 수리 완료

wp-config.php, 그렇지 않으면 누구나 서버에서 복구 스크립트를 실행할 수 있습니다.

phpMyAdmin 내에서 복구 명령을 실행할 수도 있습니다. 로그인하고 데이터베이스를 선택하세요. 모든 테이블을 확인하십시오. 선택한 항목 드롭다운 메뉴에 있는 테이블 복구 명령을 실행합니다.

phpMyAdmin 복구 테이블

마지막으로 데이터베이스 복구 기능을 사용할 수 있습니다. cPanel의 MySQL 데이터베이스 내의 데이터베이스 수정 옵션에서 사용할 수 있습니다.

데이터베이스 복구 데이터베이스 기능 수정

손상된 테마 또는 플러그인 확인

테마나 플러그인 파일이 손상된 경우 데이터베이스 연결 오류의 또 다른 원인이 될 수 있습니다.

wp-admin 에 액세스할 수 없는 경우 phpMyAdmin에서 테마를 변경할 수 있습니다.

문제가 해결되면 테마에 문제가 있는 것입니다. 오류를 해결하는 업데이트된 버전이 있는지 확인하거나 다른 테마를 사용하세요.

잘못된 플러그인을 테스트하려면 wp-admin 내에서 모든 플러그인을 비활성화하면 됩니다. wp-admin 에 액세스할 수 없는 경우 FTP 또는 파일 관리자를 통해 wp-content 내의 plugins 폴더 이름을 plugins_old 로 변경하여 플러그인을 비활성화할 수 있습니다.

파일 관리자에서 플러그인 폴더 이름 바꾸기

이제 연결 오류가 수정되었는지, wp-admin 에 액세스할 수 있는지 확인하세요. 그렇다면 플러그인 중 하나에 결함이 있는 것입니다. plugins_old 폴더의 이름을 다시 plugins 으로 바꿉니다. 그런 다음 wp-admin 에서 하나씩 활성화하고 오류가 나타나는지 확인하여 어떤 플러그인에 결함이 있는지 알아보세요.

테마와 플러그인을 확인한 후에도 WordPress에서 데이터베이스 연결 설정 중 오류가 계속 발생하는 경우 계속 읽어보세요.

WordPress 핵심 파일 복원

데이터베이스 연결 실패의 또 다른 가능한 원인은 손상된 코어 파일입니다. 이 문제를 해결하는 방법은 WordPress 핵심 파일의 새로운 복사본을 웹 공간에 업로드하는 것입니다.

계속하기 전에 먼저 백업을 해 두는 것이 좋습니다. .htaccess, 와 같은 파일을 변경한 경우 복사본을 보존하고 다른 핵심 파일이 업로드될 때 사용하는 것이 좋습니다.

https://wordpress.org/download/에서 최신 버전의 WordPress를 다운로드하세요.

WordPress 받기

파일의 압축을 풉니다. 그런 다음 wp-content 폴더와 wp-config-sample.php 파일을 삭제하세요. 이는 기존 콘텐츠를 덮어쓰거나 새 wp-config.php 파일을 생성하지 않도록 하기 위한 것입니다.

wp-content 폴더와 wp-config-sample 파일을 삭제하세요.

FTP를 사용하여 다른 모든 파일을 웹 호스트에 업로드하고 기존 파일을 덮어씁니다.

완료되면 데이터베이스 연결 문제가 사라졌는지 확인하세요. 그렇지 않은 경우 다음 단계로 진행하세요.

데이터베이스 서버가 다운되었는지 확인하세요.

WordPress에서 데이터베이스 연결 설정 오류의 또 다른 원인은 데이터베이스 서버가 올바르게 작동하지 않을 수 있다는 것입니다. 공유 호스트가 각 웹사이트에 제한된 리소스를 할당하기 때문에 공유 호스팅을 사용하는 경우 이러한 현상이 발생할 가능성이 더 높습니다. 사이트의 인기가 크게 높아진 경우 데이터베이스 서버가 필요한 증가된 데이터베이스 연결 수를 처리하지 못할 수도 있습니다.

데이터베이스 서버의 로드를 줄이는 한 가지 방법은 캐싱 플러그인을 사용하여 웹 페이지의 정적 버전을 제공하는 것입니다. 이렇게 하면 웹 서버가 콘텐츠에 액세스하기 위해 데이터베이스를 너무 자주 쿼리할 필요가 없습니다.

호스트에서 여러 WordPress 사이트를 실행 중인 경우 해당 사이트가 실행 중인지 확인하세요. 다른 서버가 다운된 경우 데이터베이스 서버에 문제가 있음을 나타낼 수 있습니다.

또한 호스팅 제공업체에 문의하여 데이터베이스 서버에 문제가 있는지 확인하고 문제가 있는 경우 언제 해결될 것으로 예상되는지 확인해야 합니다.

호스트에게 연락하세요

다른 모든 방법이 실패하면 호스트에게 연락하여 문제에 대한 도움을 요청하세요. 당신이 이미 시도한 것이 무엇인지 알려주십시오. 그들은 당신이 놓친 것을 발견할 수도 있습니다.

WordPress에서 데이터베이스 연결 설정 오류 수정

WordPress에서 데이터베이스 연결 설정 오류 메시지는 웹 사이트가 중단될 때 신속하게 정리하고 싶은 내용입니다. 다행히도 이를 해결하는 방법에는 여러 가지가 있습니다.

지금까지 가장 가능성이 높은 원인은 잘못된 데이터베이스 자격 증명입니다. 항상 이를 먼저 확인해야 합니다. 그렇지 않은 경우 데이터베이스 사용자 권한 확인, 데이터베이스 복구, 파일 손상 확인, 데이터베이스 서버가 제대로 작동하는지 확인하거나 호스트의 도움을 받을 수 있습니다.

문제를 해결하면 데이터 손실이나 지속적인 문제 없이 사이트가 다시 제대로 작동하기 시작합니다.

WordPress 문제 해결에 대한 보다 일반적인 팁을 보려면 일반 WordPress 문제 해결 및 일반적인 오류에 대한 가이드를 읽어보세요.

WordPress 사이트에서 데이터베이스 연결 설정 중 오류 메시지를 수정하는 방법에 대해 여전히 질문이 있습니까? 아래 댓글로 알려주세요!

이야! 기사를 끝까지 작성하셨습니다!