본문으로 건너뛰기

DB 비밀번호 변경 후 'Error establishing a database connection' 오류를 어떻게 해결하나요?

💡 요약 정리

  • 워드프레스는 MySQL(MariaDB)을 사용하며, DB 접속 정보는 전역 설정파일인 wp-config.php에서 관리됩니다.
  • DB 비밀번호를 변경하면, wp-config.php의 DB_PASSWORD 값도 같은 비밀번호로 반드시 업데이트해야 합니다.
  • 방법 1: FTP/SFTP(파일을 서버에 올리고 내려받는 프로그램)로 wp-config.php를 내려받아 DB_PASSWORD를 새 비밀번호로 수정 후 동일 경로에 덮어쓰기 업로드합니다.
  • 방법 2: SSH(명령줄 접속)로 서버에 접속해 vi 편집기로 wp-config.php를 열고 DB_PASSWORD 값을 새 비밀번호로 저장합니다.
  • 접속 툴/방법은 아래 링크(FTP/SFTP, SSH, MySQL 접속 방법 안내)를 참고하세요.

1. 증상과 원인

  • 증상: 워드프레스 접속 시 "Error establishing a database connection" 오류가 표시됩니다.
  • 원인: 워드프레스는 PHP로 동작하며 MySQL(MariaDB)과 연결해 데이터를 처리합니다. 이때 사용하는 DB 접속 정보는 전역 설정파일인 wp-config.php에 저장됩니다. DB 비밀번호를 변경했는데 wp-config.php의 DB_PASSWORD 값을 같이 변경하지 않으면 접속 불일치로 오류가 발생합니다.

2. 사전 준비: 접속 방법 안내

아래 중 편한 방법을 하나 선택해 진행하세요. 접속 방법이 필요하다면 가이드를 참고하십시오.

3. 해결 방법 1: FTP/SFTP 접속을 통한 수정

  1. FTP 클라이언트로 서버에 접속합니다.

  2. 사이트 루트에서 wp-config.php를 다운로드합니다.

    • 파일을 선택한 뒤 더블 클릭하거나, 마우스 오른쪽 메뉴에서 다운로드를 선택합니다.
FTP에서 wp-config.php 파일 위치 예시 화면
  • FTP 클라이언트에서 파일 목록과 위치를 확인하는 예시입니다.
wp-config.php 파일 다운로드 예시 화면
  • wp-config.php 파일을 선택해 다운로드하는 예시입니다.
  1. 메모장 등 텍스트 편집기로 wp-config.php를 엽니다.
    • 윈도우 기본 메모장이나 AcroEdit 같은 텍스트 에디터로 파일을 엽니다.
텍스트 편집기에서 wp-config.php 파일을 여는 예시 화면
  • 텍스트 기반 편집기로 파일을 열어 수정할 준비를 합니다.
  1. 파일에서 DB_PASSWORD 값을 새 비밀번호로 수정합니다.
    • define( 'DB_PASSWORD', 'athl*******' ); 항목을 새로운 비밀번호로 변경합니다.
ex) DB 패스워드를 newpassword2022로 변경한 경우
define( 'DB_PASSWORD', 'newpassword2022' );
로 수정후 저장
  1. 수정한 wp-config.php를 동일 경로에 다시 업로드(덮어쓰기)합니다.
    • 업로드 경로가 기존 wp-config.php 파일 경로와 같은지 확인 후 덮어쓰기 합니다.
수정된 wp-config.php 파일을 동일 경로로 업로드하는 예시 화면
  • 동일 경로에 덮어쓰기로 업로드하는 예시입니다.

4. 해결 방법 2: SSH 접속을 통한 수정 (예: PuTTY, SecureCRT)

  1. SSH로 접속합니다. 기본 포트는 22입니다.
PuTTY를 이용한 SSH 접속 설정 예시 화면
  • 호스트, 포트(22) 등의 기본 접속 정보를 입력하는 예시입니다.
  1. vi 편집기로 wp-config.php 파일을 수정합니다.
    • 터미널에서 vi 편집기로 wp-config.php를 열어 DB_PASSWORD 값을 새로운 DB 비밀번호로 변경합니다.
    • 수정 후 저장합니다.
vi 편집기에�서 wp-config.php 파일을 열어 수정하는 예시 화면

  • vi에서 파일을 열고 값을 수정하는 예시 화면입니다.

  • vi 편집기 사용법 참고: 가이드 문서