[MySQL] Workbench 실행 오류 ‘외부 구성 요소에서 예외를 Throw했습니다’ 해결하기 (3가지 방법)

문제 상황 (The Problem)

MySQL Workbench를 실행하거나 Server Status 등 특정 메뉴를 클릭했을 때, 갑자기 프로그램이 멈추면서 아래와 같은 에러 팝업이 뜨고 강제 종료되는 현상이 발생했다.

에러 메시지:

MySQL Workbench has encountered a problem
외부 구성 요소에서 예외를 Throw했습니다.
We are sorry for the inconvenience but an unexpected exception has been raised…

스크린샷 예시:

재부팅을 해도 해결되지 않고, 프로그램을 재설치해도 기존 설정이 남아있어 똑같은 오류가 무한 반복되었다.

원인 (The Cause)

내가 겪은 경우와 검색한 사례들을 정리해 보면, 이 오류는 주로 두 가지 이유로 발생한다.

설정 파일 손상
- 윈도우 업데이트나 비정상 종료 후, Workbench의 사용자 설정 파일(user_config.xml 등)이 깨지거나 꼬인 경우
- 가장 흔한 케이스
포트/서비스 충돌
- 같은 PC에 MariaDB가 함께 설치되어 있고
- MySQL과 동일한 포트(기본 3306)를 두고 서비스가 충돌하는 경우

그래서 해결 전략은 크게 두 가지다.

(1) 설정 파일을 초기화해서 깨끗하게 시작하기
(2) 포트/서비스 충돌이 의심되면 MariaDB 서비스를 잠시 내려 보기

아래 세 가지 방법 중에서 편한 방법을 골라 실행하면 된다. (보통 1번이나 2번에서 해결된다.)

해결 방법 (The Solution)

방법 1. 윈도우 탐색기로 Workbench 설정 초기화 (가장 쉬운 방법)

복잡한 명령어가 싫다면 이 방법을 추천한다. MySQL Workbench를 완전히 종료한 상태에서 진행해야 한다.

Win + R 키를 눌러 실행 창을 연다.
입력창에 아래를 입력하고 엔터를 누른다.
```
%APPDATA%\MySQL
```
열리는 폴더 안에서 Workbench 라는 폴더를 찾는다.
이 폴더를 바로 삭제해도 되지만, 혹시 몰라 백업을 남기고 싶다면 이름을 Workbench_old 정도로 변경한다.
MySQL Workbench를 다시 실행하면, 설정 파일이 초기화되면서 새 Workbench 폴더가 생성되고 정상적으로 켜지는지 확인한다.

이 방법은 설정만 초기화하는 것이기 때문에, 실제 데이터베이스나 스키마에는 영향을 주지 않는다.

방법 2. Git Bash로 3초 만에 설정 폴더 백업 (개발자 추천)

마우스로 클릭하는 것보다 터미널이 익숙하다면, Git Bash에서 한 번에 설정 폴더를 백업하고 초기화할 수 있다.

1. Git Bash 실행

평소 사용하던 Git Bash 터미널을 연다. (Windows 시작 메뉴에서 Git Bash 검색)

2. 아래 스크립트 복사 & 붙여넣기

이 스크립트는 %APPDATA%\MySQL 경로로 이동한 뒤, Workbench 폴더가 있으면 날짜·시간이 붙은 이름으로 안전하게 백업한다.

# 1. Windows AppData/MySQL 경로로 이동
cd "$APPDATA/MySQL" || { echo "❌ 경로를 찾을 수 없습니다."; exit 1; }

# 2. Workbench 폴더가 존재하면 백업(이름 변경) 수행
if [ -d "Workbench" ]; then
  # 오늘 날짜와 시간을 파일명에 붙여서 백업 (예: Workbench_backup_20250520_123000)
  BACKUP_NAME="Workbench_backup_$(date +%Y%m%d_%H%M%S)"
  mv Workbench "$BACKUP_NAME"

  echo "설정 폴더가 '$BACKUP_NAME'으로 백업되었습니다."
  echo "이제 MySQL Workbench를 다시 실행해보세요!"
else
  echo "⚠ 'Workbench' 폴더가 없습니다. 이미 삭제되었거나 경로가 다를 수 있습니다."
fi

실행 후 Workbench를 다시 켜서 오류가 재현되는지 확인한다.
대부분의 “외부 구성 요소에서 예외를 Throw했습니다” 오류는 여기까지 하면 해결된다.

방법 3. MariaDB 서비스 충돌 확인 및 중지

위의 설정 초기화로도 해결되지 않는다면, 포트 충돌을 의심해볼 수 있다.

내 PC에 MariaDB가 함께 설치되어 있다면, MySQL과 동일한 포트(기본 3306)를 사용하려다가 충돌이 나면서 Workbench가 비정상 종료될 수 있다.

이때는 실행 중인 MariaDB 서비스를 잠시 꺼 주면 해결되기도 한다.

1. 관리자 권한으로 CMD(명령 프롬프트) 실행

윈도우 검색창에 cmd를 입력한다.
명령 프롬프트를 마우스 오른쪽 버튼 클릭 → ‘관리자 권한으로 실행’을 선택한다.

2. MariaDB 서비스 중지

아래 명령어를 입력해 MariaDB 서비스를 중지한다.

net stop mariadb

성공 메시지를 확인한 뒤, 다시 MySQL Workbench를 실행해 본다.

이후에 MariaDB가 다시 필요하다면 net start mariadb 로 서비스를 다시 올릴 수 있다.

정리 및 느낀 점

Workbench가 갑자기 죽으면서 “외부 구성 요소에서 예외를 Throw했습니다” 오류가 뜰 때는
(1) 설정 파일 초기화 → (2) 포트/서비스 충돌 확인 순서로 점검하면 훨씬 빠르게 해결할 수 있었다.
특히 %APPDATA%\MySQL\Workbench 폴더가 꼬였을 때는, 폴더 이름만 바꿔 줘도 새 설정으로 깔끔하게 시작할 수 있다는 점을 알게 되었다.
MariaDB와 MySQL을 같이 쓰는 환경이라면, 서비스/포트 충돌 가능성을 항상 염두에 두고 확인하는 습관이 필요하다.

혹시 이 글로도 해결이 안 되거나 다른 유형의 Workbench 오류를 겪고 있다면, 에러 메시지와 함께 댓글로 남겨 주세요. 내가 겪어 본 범위 안에서 최대한 같이 원인을 좁혀 보겠습니다.

Kyuchani