The error (2002) Can't connect to ...
오류 메시지·상태명
빠른 답변
- 이 오류는 무엇인가요?
- MySQL 오류 2002는 서버가 실행 중이지 않거나 연결에 사용한 Unix socket 파일 이름 또는 TCP/IP 포트 번호가 올바르지 않을 때 일반적으로 표시됩니다.
- 가장 흔한 원인은 무엇인가요?
- The error (2002) Can't connect to ...는 MySQL 서버가 실행 중이지 않거나 연결에 사용한 Unix socket 파일 이름 또는 TCP/IP 포트 번호가 올바르지 않을 때 일반적으로 표시됩니다.
- 무엇을 먼저 확인해야 하나요?
- 현재 화면 또는 로그의 오류 문자열에 오류 코드 `2002`와 `Can't connect to ...`가 포함되는지 원문과 대조합니다.
현재 증상
- 애플리케이션 오류 메시지
- 데이터베이스 연결 실패
먼저 확인할 항목
현재 화면 또는 로그의 오류 문자열에 오류 코드 `2002`와 `Can't connect to ...`가 포함되는지 원문과 대조합니다.
피해야 할 조치
주의
- Unix socket 파일 연결은 같은 컴퓨터에서만 사용할 수 있습니다.
- 기본 Unix socket 파일과 TCP/IP 포트는 실제 설정과 다를 수 있습니다.
환경별 원인과 조치
증상
The error (2002) Can't connect to ...가 화면 또는 로그에 표시됩니다.
확인
현재 화면 또는 로그의 오류 문자열에 오류 코드 2002와 Can't connect to ...가 포함되는지 원문의 오류 메시지와 대조합니다.
판정
오류 코드 2002와 Can't connect to ...가 원문과 일치하면, MySQL 공식 문서는 MySQL 서버가 실행 중이지 않거나 연결에 사용한 Unix socket 파일 이름 또는 TCP/IP 포트 번호가 올바르지 않은 경우를 일반적인 의미로 설명합니다. 사용 중인 TCP/IP 포트가 방화벽 또는 포트 차단 서비스에 의해 차단되었는지도 확인 대상입니다.
주의사항
- Unix socket 파일 연결은 같은 컴퓨터에서만 사용할 수 있습니다.
- 기본 Unix socket 파일은
/tmp/mysql.sock이고 기본 MySQL 포트는3306이지만, 실제 설정은 다를 수 있습니다.
출처: MySQL 8.0 Reference Manual — Can't connect to [local] MySQL server (새 창에서 열림)
참고 자료
MySQL · 공식 자료 (새 창에서 열림)
확인 범위: MySQL 공식 문서는 오류 2002가 MySQL 서버 미실행 또는 잘못된 Unix socket 파일 이름이나 TCP/IP 포트 번호를 일반적인 의미로 설명합니다., MySQL 공식 문서는 사용 중인 TCP/IP 포트가 방화벽 또는 포트 차단 서비스에 의해 차단되지 않았는지 확인하도록 안내합니다. · 확인일: 2026-07-24