컴퓨터 TIP

WSL(Ubuntu)에 MariaDB 설치 오류 해결 (ERROR 2002 (HY000))

theplainest 2025. 3. 3. 01:47

최근 웹 개발을 위해 윈도우에 Ubuntu를 WSL을 이용하여 설치할 일이 있었다. Ubuntu 22.04는 아주 잘 설치되었는데, MariaDB는 아무리 설치해도 실행이 안 되는 문제가 발생했다.

인터넷을 아주 많이 찾아보았는데, 나와 완전히 같은 케이스를 발견할 수 없었기 때문에 어떻게 해결했는지 적어보려고 한다. 물론 왜 이런 오류가 발생하는지는 아직 모르겠다.

 

MariaDB 설치

간단한 코드 두 줄이면 설치된다.

sudo apt update
sudo apt install mariadb-server mariadb-client

그리고 이제 다음 코드로 접속되는지 확인해 보면,

sudo mariadb

ERROR 2002 (HY000): Can't connect to local MySQL server through socket '/run/mysqld/mysqld.sock'

 

라는 오류가 뜨게 된다. 아무리 지우고 재설치해도 마찬가지의 오류가 뜨는 걸 경험할 수 있다.

 

오류 해결

나의 경우, 실제로 해당 주소에 가면 mysqld.sock 폴더가 존재하지 않았다.

 

그런 와중 https://arcticwillow.tistory.com/5 이 글을 읽고, /var/log/mysql 을 확인해보았는데 작성자분과 똑같이 나와서 나는 포트 겹침 문제라고 착각했다. 이외에도 많은 사람들이 포트 겹침 문제로 같은 오류를 겪어서, 나도 포트 번호를 바꾸고 방화벽을 설정하는 등의 엄청난 삽질을 했는데 결과적으로는 이 문제가 아니었다.

 

진짜 포트 겹침 문제라면, 

cat /var/log/mysql/error.log

에 포트가 겹쳤다고 적혀있어야 한다. 물론 난 아무것도 적혀있지 않았다.

 

해결방법은 아주 간단했다.

sudo service mysql restart

를 입력만 하면 해결된다.

 

그냥 단순히 mysql이 실행되지 않아서 발생했던 문제. 비슷한 코드인

sudo systemctl restart mariadb

위 코드를 실행하려 하면 

 

System has not been booted with systemd as init system (PID 1). Can't operate.
Failed to connect to bus: Host is down

 

이라는 오류가 뜨는 것도 원인을 파악하기 어렵게 만들었다. 찾아보니 WSL에서는 기본적으로 systemctl 명령어를 사용할 수 없다고 한다.