1049: Unknown database 'name'

의미

접속하거나 사용하려는 데이터베이스(스키마)가 서버에 존재하지 않는다. USE 문이나 연결 문자열의 기본 데이터베이스 이름이 존재하지 않는 스키마를 가리킨다.

원인

데이터베이스가 생성된 적이 없거나, 이름의 철자가 틀렸거나(대소문자 구분은 운영체제에 따라 다를 수 있음), 삭제되었거나, 애플리케이션이 잘못된 환경(dev/prod)에 연결하는 경우다. 새 서버로 이전할 때 스키마가 마이그레이션되지 않은 것도 흔한 원인이다.

해결 방법

기존 데이터베이스 목록 확인: SHOW DATABASES; 이름의 철자와 대소문자가 일치하는지 확인한다(lower_case_table_names 설정이 중요하다). 존재하지 않으면 생성한다: CREATE DATABASE database_name CHARACTER SET utf8mb4; 또는 백업에서 복원한다. 애플리케이션 연결 구성에서 대상 환경을 확인한다.