DEV WIKI
백엔드 · 오류 메시지·상태명 확인

ERROR 2002 (HY000): Can't connect to local MySQL server through socket '/tmp/mysql.sock' (2)

로컬 MySQL 서버에 연결할 때 서버 데몬 또는 서비스가 실행되지 않아 표시되는 오류 메시지를 식별합니다.

빠른 답변

확인 범위
로그인 시 `ERROR 2002 (HY000): Can't connect to local MySQL server through socket '/tmp/mysql.sock' (2)`가 표시되면 공식 문서는 Unix의 MySQL 서버 데몬 또는 Windows의 MySQL 서비스가 실행되지 않는 상태를 의미한다고 설명합니다.
먼저 확인할 항목
MySQL 로그인 시 표시된 오류 문자열이 `ERROR 2002 (HY000): Can't connect to local MySQL server through socket '/tmp/mysql.sock' (2)`와 일치하는지 확인합니다. 일치하면 공식 문서가 설명한 로컬 MySQL 서버 데몬 또는 서비스가 실행되지 않은 상태에 해당합니다.
적용 범위
화면 또는 로그에 같은 오류 메시지·상태명이 표시된 경우
출처 확인일
2026-08-04
최종 검토
2026-08-04
관련 기술
오류·수정 제보 (새 창에서 열림)

이 문서의 범위

이 문서는 화면·로그의 오류 메시지 또는 상태명을 공식 자료와 대조하는 데 사용합니다. 이 문구만으로 실제 원인이나 변경 방법을 확정하지 않으며, 아래 관련 기술 문서에서 적용 환경을 추가로 확인해야 합니다.

현재 증상

  • 데이터베이스 연결 실패

먼저 확인할 항목

MySQL 로그인 시 표시된 오류 문자열이 `ERROR 2002 (HY000): Can't connect to local MySQL server through socket '/tmp/mysql.sock' (2)`와 일치하는지 확인합니다. 일치하면 공식 문서가 설명한 로컬 MySQL 서버 데몬 또는 서비스가 실행되지 않은 상태에 해당합니다.

오류 메시지·상태명 확인 범위

ERROR 2002 (HY000): Can't connect to local MySQL server through socket '/tmp/mysql.sock' (2)'

MySQL에 로그인할 때 다음 오류 메시지가 표시되면 공식 문서는 로컬 MySQL 서버가 실행되지 않은 상태를 의미한다고 설명합니다.

ERROR 2002 (HY000): Can't connect to local MySQL server through socket '/tmp/mysql.sock' (2)

Unix에서는 MySQL 서버 데몬, Windows에서는 MySQL 서비스가 실행되지 않은 상태를 뜻합니다. 운영체제에 맞는 MySQL 설치 문서의 서버 시작 절차를 확인하거나 관리자에게 문의합니다.

이 문서는 오류 메시지의 의미를 식별하는 범위만 다룹니다. 원문에는 서버 시작 명령과 시작 후 성공 판정 기준이 제시되어 있지 않습니다.

참고 자료

MySQL :: MySQL 8.0 Reference Manual :: 5.1 Connecting to and Disconnecting from the Server (새 창에서 열림)

Oracle MySQL · 공식 자료 · 확인 범위: MySQL 로그인 시 해당 오류 메시지가 표시될 수 있습니다., 공식 문서는 이 메시지가 Unix의 MySQL 서버 데몬 또는 Windows의 MySQL 서비스가 실행되지 않은 상태를 의미한다고 설명합니다., 공식 문서는 운영체제에 맞는 MySQL 설치 문서의 서버 시작 절차를 확인하도록 안내합니다. · 확인일: 2026-08-04

ERROR 2002 (HY000): Can't connect to local MySQL server through socket '/tmp/mysql.sock' (2) | DEV WIKI