API_IF_개발

[MySQL 5.5] SQL Error (2003) 원격 접속 오류 해결 방법 (127.0.0.1 연결 실패)

피오농부 2025. 4. 22. 06:46
반응형

MySQL 5.5 환경에서 SQL Error (2003): Can't connect to MySQL server on '127.0.0.1' (10061) 오류가 발생했다면, 원격 접속 설정 문제일 가능성이 큽니다. 이 포스팅에서는 해당 오류 메시지가 발생하는 이유와 해결 방법을 자세히 소개합니다.


목차

  1. SQL Error (2003) 오류 메시지 설명
  2. MySQL 원격 접속이 안 되는 주요 원인
  3. MySQL 서버 설정 확인 방법
  4. 방화벽 및 포트 설정 점검
  5. 해결 방법 요약
  6. 추가 참고자료

1. SQL Error (2003) 오류 메시지 설명

오류 메시지:

SQL Error (2003): Can't connect to MySQL server on '127.0.0.1' (10061)

이 오류는 일반적으로 클라이언트가 MySQL 서버에 접근하지 못할 때 발생합니다. 로컬에서는 접속이 되는데, 다른 장치(클라이언트)에서 접속하려 할 때 문제가 생기는 경우가 많습니다.


2. MySQL 원격 접속이 안 되는 주요 원인

  • bind-address 설정이 127.0.0.1로 되어 있음
  • MySQL 사용자 계정이 원격 접속을 허용하지 않음
  • Windows 방화벽 또는 라우터 포트 설정 미비
  • MySQL 서비스가 실행 중이지 않음

3. MySQL 서버 설정 확인 방법

✅ my.cnf 또는 my.ini 파일 확인

[mysqld]
bind-address = 0.0.0.0
  • 기본값이 127.0.0.1이면 로컬호스트에서만 접속 허용
  • 0.0.0.0 또는 실제 서버 IP로 변경 후 MySQL 재시작 필요

✅ 사용자 계정 권한 부여

GRANT ALL PRIVILEGES ON *.* TO 'root'@'%' IDENTIFIED BY 'your_password';
FLUSH PRIVILEGES;
  • '%'는 모든 IP에서 접속 가능하도록 허용
  • 보안을 위해 특정 IP만 허용하는 것이 더 안전

4. 방화벽 및 포트 설정 점검

✅ Windows 방화벽 예외 설정

  • 3306 포트(기본 MySQL 포트)가 열려 있는지 확인
  • 인바운드 규칙에 MySQL 포트 추가

✅ 공유기 환경일 경우

  • 라우터에서 포트 포워딩 설정
  • 외부에서 접속 시 내부 서버로 라우팅되도록 설정

5. 해결 방법 요약

문제 원인 해결 방법

서버에서만 접속됨 bind-address 수정 (0.0.0.0)
사용자 권한 제한 GRANT 명령으로 원격 접속 허용
포트 차단 방화벽 및 라우터 포트 3306 개방
서비스 미작동 MySQL 서비스 실행 상태 확인

설정 후에는 반드시 MySQL 서버를 재시작해야 변경 사항이 적용됩니다.


6. 추가 참고자료

반응형