톰캣 Unable to open debugger port 에러 - 디버깅 포트 충돌 문제 해결하기 (IntelliJ)

문제

인텔리제이에서 톰캣 서버를 디버그 모드로 실행하려고 할 때

Unable to open debugger port (127.0.0.1:15547): java.net.BindException "Address already in use: bind"

와 같은 에러 메시지가 발생하며 서버 실행이 되지 않는 문제가 발생함.

---

원인

• 디버거 포트(예: 15547번) 가 이미 다른 프로세스(예: 이전에 실행된 톰캣, 혹은 다른 자바 프로세스)에서 사용 중이기 때문이다.
• 즉, 한 포트를 두 개 이상의 프로그램이 동시에 사용하려고 할 때 발생하는 충돌 문제.
• 주로 톰캣 서버를 완전히 종료하지 않고 재실행할 때, 또는 IDE(인텔리제이 등)에서 서버가 비정상적으로 남아 있을 때 자주 발생함

---

해결

1. 톰캣/Java 프로세스 완전히 종료하기
   •  인텔리제이의 "Stop" 버튼(빨간 네모)을 눌러 서버를 종료
   •  그래도 안 될 때는 명령 프롬프트(cmd)에서 해당 포트를 사용 중인 프로세스를 찾아 강제 종료

netstat -ano | findstr 455// 포트 점유 프로세스(PID) 확인 
taskkill /PID [PID] /F // 해당 PID 강제 종료 ([PID]는 실제 숫자로)

2. 디버그 포트 변경(임시방편)
   •  인텔리제이 상단 메뉴에서 Run > Edit Configurations로 이동
   •  실행 환경(Debug/Run) 설정에서 "Debugger"의 포트 번호를 5005 등 다른 값으로 변경
   •  저장 후 톰캣을 다시 실행
3. IDE 및 컴퓨터 재시작
   •  IDE(인텔리제이)를 완전히 종료 후 재실행
   •  여전히 해결되지 않으면 컴퓨터를 재부팅

---

결론

이 에러는 톰캣의 디버깅 포트가 이미 다른 프로세스에서 사용 중일 때 발생하는
단순한 포트 충돌 문제입니다.

서버/프로세스 완전 종료, 포트 변경, IDE 재시작, 필요시 컴퓨터 재부팅 등
위 단계들을 차례대로 시도하면 대부분 쉽게 해결할 수 있습니다.