MySQL 오류 2002: 소켓을 통해 연결할 수 없음
클라이언트가 로컬 Unix 소켓을 시도했지만 서버를 찾을 수 없습니다. 서버가 실행 중이 아니거나, 다른 소켓 경로를 사용 중이거나, TCP 연결을 의미했을 수 있습니다.
- 오류 번호
2002- 이름
CR_CONNECTION_ERROR- 카테고리
- 연결 및 클라이언트
의미
다음에 연결할 때 localhost Unix에서는 MySQL 클라이언트가 TCP 대신 Unix 소켓 파일을 사용합니다. 2002는 소켓 파일이 없거나 그 위에서 수신 대기하는 것이 없다는 뜻입니다. 괄호 안의 숫자는 운영 체제 오류로, 예를 들면 (2) 은 파일이 없을 때이고, (111) 은 연결이 거부된 경우입니다.
이것은 클라이언트 오류입니다: 요청이 서버에 도달하지 않았습니다.
일반적인 원인
- MySQL 서버가 실행 중이 아니거나, 시작 시 충돌이 발생했습니다.
- 서버의 소켓은 클라이언트가 예상하는 곳과 다른 곳에 있습니다(예를 들어
/var/run/mysqld/mysqld.sock대/tmp/mysql.sock). - 서버가 Docker나 다른 기기에서 실행되어 로컬 소켓이 없으므로 TCP를 사용해야 합니다.
- 소켓 디렉토리의 권한 때문에 클라이언트가 접근하지 못합니다.
해결 방법
-
서버가 실행 중인지 확인하고, 그렇지 않다면 오류 로그를 확인하세요. 예를 들어
systemctl status mysqlLinux에서 또는brew services listmacOS에서. -
소켓 대신 TCP로 연결하려면 다음을 사용하세요
127.0.0.1를 사용하고localhost, 또는--protocol=TCP.mysql -h 127.0.0.1 -P 3306 -u app -p
-
서버가 로컬에서 실행 중이라면, 소켓 경로를 찾아 클라이언트를 해당 경로로 지정하세요.
-- On the server: SHOW VARIABLES LIKE 'socket'; -- Client: mysql --socket=/var/run/mysqld/mysqld.sock -u app -p
관련 오류
2003호스트의 MySQL 서버에 연결할 수 없음2005알 수 없는 MySQL 서버 호스트2013쿼리 중 MySQL 서버와의 연결이 끊겼습니다53SQL Server: 네트워크 관련 또는 인스턴스별 오류08006PostgreSQL: 연결 실패
그 밖의 연결 및 클라이언트 오류
2006MySQL 서버와의 연결이 끊어짐2055다음 단계에서 MySQL 서버와의 연결이 끊겼습니다2026SSL 연결 오류2059인증 플러그인을 불러올 수 없습니다2061인증 플러그인이 오류를 보고했습니다1251클라이언트가 인증 프로토콜을 지원하지 않습니다3159안전하지 않은 전송 금지1158통신 패킷 읽기 오류
코드와 메시지 텍스트의 출처는 다음과 같습니다 MySQL 8.4 오류 메시지 참조. 전체 목록은 MySQL 오류 목록 또는 모든 데이터베이스 오류 검색.
SQLly에서 MySQL 작업하기
스키마를 아는 IntelliSense, 위험한 문장에 대한 가드레일, 명확한 오류 메시지를 갖춘 macOS, Windows, Linux용 네이티브 SQL 클라이언트입니다. MySQL은 물론 평소 쓰는 다른 데이터베이스까지 지원합니다.