본문 바로가기
카테고리 없음

Laravel에서 'SQLSTATE[HY000] [1045] Access denied' 오류 해결하기

by blogfine 2025. 2. 22.

Laravel에서 'SQLSTATE[HY000] [1045] Access denied' 오류란?

'SQLSTATE[HY000] [1045] Access denied' 오류는 Laravel을 사용할 때 데이터베이스에 연결하려고 할 때 자주 발생하는 오류입니다. 이 오류는 주로 MySQL 서버에 연결할 때 **사용자 인증 실패** 또는 **잘못된 데이터베이스 접근 권한** 때문에 발생합니다. 이 오류는 데이터베이스 연결 설정에 문제가 있을 때 발생하며, 이를 해결하기 위해서는 몇 가지 기본적인 점검을 해야 합니다.

'SQLSTATE[HY000] [1045] Access denied' 오류 발생 원인

이 오류가 발생하는 주된 원인은 다음과 같습니다:

  • 잘못된 MySQL 사용자 이름 또는 비밀번호: 데이터베이스 연결 정보가 잘못된 경우 발생합니다.
  • 잘못된 호스트 이름: 데이터베이스 서버의 호스트가 올바르지 않거나 서버에 연결할 수 없는 경우입니다.
  • 사용자에게 부여된 권한 부족: 지정된 사용자에게 데이터베이스에 대한 접근 권한이 없을 때 발생할 수 있습니다.
  • 환경 설정 파일 (.env)의 잘못된 설정: Laravel에서 사용하는 데이터베이스 환경 설정이 잘못된 경우에도 이 오류가 발생할 수 있습니다.

1. .env 파일에서 데이터베이스 설정 확인

Laravel에서는 데이터베이스 연결 설정을 .env 파일에 저장합니다. 따라서 가장 먼저 해야 할 일은 .env 파일을 열고 **DB 설정**을 확인하는 것입니다. 다음은 .env 파일의 데이터베이스 관련 설정 예시입니다:

DB_CONNECTION=mysql
DB_HOST=127.0.0.1
DB_PORT=3306
DB_DATABASE=your_database
DB_USERNAME=your_username
DB_PASSWORD=your_password

위 설정에서 **DB_HOST**, **DB_USERNAME**, **DB_PASSWORD**, **DB_DATABASE**가 정확한지 확인합니다. **DB_HOST**는 MySQL 서버의 IP 주소 또는 호스트명이 되어야 하며, **DB_USERNAME**과 **DB_PASSWORD**는 해당 데이터베이스에 접근할 수 있는 MySQL 사용자 계정 정보여야 합니다.

2. MySQL 사용자 권한 확인

'SQLSTATE[HY000] [1045] Access denied' 오류는 MySQL 사용자에게 해당 데이터베이스에 접근할 권한이 없을 때 발생할 수 있습니다. MySQL에서 사용자가 데이터베이스에 접근할 수 있도록 권한을 부여하려면, MySQL에 접속하여 다음 명령어를 실행합니다:

GRANT ALL PRIVILEGES ON your_database.* TO 'your_username'@'localhost' IDENTIFIED BY 'your_password';
FLUSH PRIVILEGES;

위 명령어는 **your_database**에 대한 모든 권한을 **your_username** 사용자에게 부여합니다. **localhost** 대신 특정 IP 주소를 지정할 수도 있습니다. 권한을 부여한 후에는 **FLUSH PRIVILEGES** 명령어를 사용하여 변경 사항을 반영해야 합니다.

3. MySQL 사용자와 비밀번호 재설정

비밀번호가 정확하지 않거나 MySQL 사용자 계정에 문제가 있을 수 있습니다. 이 경우 MySQL에서 사용자 계정을 삭제하고 새로 생성하는 방법이 있습니다. 다음 명령어로 사용자 계정을 삭제하고 새 비밀번호를 설정할 수 있습니다:

DROP USER 'your_username'@'localhost';
CREATE USER 'your_username'@'localhost' IDENTIFIED BY 'your_new_password';
GRANT ALL PRIVILEGES ON your_database.* TO 'your_username'@'localhost';
FLUSH PRIVILEGES;

이 명령어는 기존 사용자를 삭제하고 새 비밀번호를 가진 사용자를 생성한 후, 해당 데이터베이스에 대한 권한을 부여합니다. 이를 통해 MySQL 사용자 계정 문제를 해결할 수 있습니다.

4. MySQL 서버의 접근 허용 IP 설정 확인

서버가 외부에서 접근할 수 없을 때도 이 오류가 발생할 수 있습니다. MySQL 서버의 **`bind-address`** 설정이 127.0.0.1로 되어 있다면 외부에서 접근이 불가능합니다. 이를 해결하려면 MySQL 설정 파일 (보통 /etc/mysql/my.cnf)을 열고 **bind-address**를 변경합니다:

bind-address = 0.0.0.0

이렇게 설정하면 MySQL 서버가 모든 IP 주소에서 접근할 수 있도록 허용됩니다. 설정 후 MySQL 서비스를 재시작하여 적용합니다:

sudo systemctl restart mysql

5. 캐시 및 구성 파일 재생성

데이터베이스 설정을 수정한 후 Laravel에서 변경 사항이 반영되지 않는 경우가 있습니다. 이때는 Laravel의 캐시를 클리어하고 구성을 다시 생성해야 합니다. 이를 위해 다음 명령어를 실행합니다:

php artisan config:clear
php artisan cache:clear
php artisan config:cache

위 명령어는 캐시를 지우고, 구성을 다시 캐싱하여 Laravel이 최신 설정을 반영하도록 합니다.

결론

'SQLSTATE[HY000] [1045] Access denied' 오류는 Laravel에서 MySQL 데이터베이스에 연결할 때 자주 발생하는 문제입니다. 이 오류는 **잘못된 데이터베이스 설정**, **사용자 권한 문제**, **잘못된 비밀번호** 등 여러 가지 이유로 발생할 수 있습니다. 위의 방법들을 따라가며 문제를 해결해 보세요. 데이터베이스 설정을 정확하게 확인하고, 권한을 부여하며, 필요한 경우 MySQL 설정을 변경하는 것으로 이 오류를 해결할 수 있습니다. Laravel에서의 데이터베이스 연결 문제를 해결하고 더 나은 개발 환경을 만들어 보세요.

티스토리툴바