시스템 관리_26 아파치 톰캣 Address already in use bind 포트 충돌 오류 원인과 완벽 해결 가이드

# 1. 톰캣 catalina.out 또는 아파치 error.log에서 포트 바인딩 실패 확인
$ tail -n 30 /opt/tomcat/logs/catalina.out
# [출력 예시 - Tomcat 8080 포트 또는 8005 셧다운 포트 충돌]
# SEVERE [main] org.apache.catalina.core.StandardServer.await Failed to create server shutdown socket on address [localhost] and port [8005]
# java.net.BindException: Address already in use (Bind failed)
# 또는
# org.apache.catalina.LifecycleException: Protocol handler start failed
# Caused by: java.net.BindException: Address already in use: bind <null>:8080

# [출력 예시 - Apache 80 또는 443 포트 충돌]
# (98)Address already in use: AH00072: make_sock: could not bind to address 0.0.0.0:80
# no listening sockets available, shutting down

# 2. 문제가 되는 포트(예: 80, 8080, 8005)를 점유하고 있는 프로세스(PID) 및 프로그램명 확인
$ sudo ss -tulpn | grep -E ':(80|8080|8005)\s'
# tcp   LISTEN 0      100        0.0.0.0:8080       0.0.0.0:*    users:(("java",pid=15420,fd=45))
# tcp   LISTEN 0      511        0.0.0.0:80         0.0.0.0:*    users:(("nginx",pid=1120,fd=6))

# 3. lsof 명령어로 충돌 포트를 물고 있는 정확한 프로세스 상세 정보 추출
$ sudo lsof -i :8080
# COMMAND   PID   USER   FD   TYPE DEVICE SIZE/OFF NODE NAME
# java    15420 tomcat   45u  IPv6 125432      0t0  TCP *:8080 (LISTEN)

# 4. fuser 명령어를 사용하여 해당 포트를 잡고 있는 PID 직접 조회
$ sudo fuser 8080/tcp
# 8080/tcp:            15420

# 5. 기존 인스턴스가 좀비/행(Hang) 상태로 남아있는지 프로세스 목록 조회
$ ps -ef | grep -E 'tomcat|httpd|apache2' | grep -v grep

#!/bin/bash
# resolve_port_conflict.sh - Find and terminate processes causing "Address already in use: bind"

TARGET_PORT=${1:-"8080"}

if [ "$EUID" -ne 0 ]; then
    echo "오류: 포트 점유 프로세스를 조회 및 종료하려면 루트(root) 권한이 필요합니다."
    echo "사용법: sudo $0 [포트번호]"
    exit 1
fi

echo "=========================================="
echo " [포트 충돌 진단 및 해제] 대상 포트: ${TARGET_PORT}"
echo "=========================================="

# 1. 포트 점유 여부 확인
PID_LIST=$(lsof -t -i :"$TARGET_PORT" 2>/dev/null)

if [ -z "$PID_LIST" ]; then
    echo "  [정상] 포트 ${TARGET_PORT}번은 현재 비어 있습니다 (충돌 없음)."
    
    # TIME_WAIT 상태 소켓 여부 체크
    TW_COUNT=$(ss -tan state time-wait | grep -c ":${TARGET_PORT}\s")
    if [ "$TW_COUNT" -gt 0 ]; then
        echo "  [참고] 프로세스는 없으나 TIME_WAIT 소켓이 ${TW_COUNT}개 남아 있습니다."
        echo "  -> SO_REUSEADDR 미적용 시 일시적 바인딩 지연이 발생할 수 있습니다."
    fi
    exit 0
fi

echo "  [경고] 포트 ${TARGET_PORT}번을 점유 중인 프로세스 감지:"
for PID in $PID_LIST; do
    PROC_NAME=$(ps -p "$PID" -o comm= 2>/dev/null)
    PROC_CMD=$(ps -p "$PID" -o args= 2>/dev/null | cut -c 1-80)
    echo "  -> PID: ${PID} | 명령: ${PROC_NAME} (${PROC_CMD}...)"
done

# 2. 프로세스 안전 종료 (SIGTERM)
echo -e "\n[1] 프로세스 정상 종료 시도 (SIGTERM)..."
kill -15 $PID_LIST 2>/dev/null
sleep 2

# 3. 종료 확인 및 강제 종료 (SIGKILL)
STILL_RUNNING=$(lsof -t -i :"$TARGET_PORT" 2>/dev/null)
if [ -n "$STILL_RUNNING" ]; then
    echo "  [주의] 프로세스가 2초 내에 종료되지 않았습니다. 강제 종료(SIGKILL)를 수행합니다."
    kill -9 $STILL_RUNNING 2>/dev/null
    sleep 1
fi

# 4. 최종 결과 검증
FINAL_CHECK=$(lsof -t -i :"$TARGET_PORT" 2>/dev/null)
if [ -z "$FINAL_CHECK" ]; then
    echo -e "\n[성공] 포트 ${TARGET_PORT}번이 정상적으로 해제되었습니다."
    echo "이제 아파치 또는 톰캣 서비스를 다시 기동할 수 있습니다."
else
    echo -e "\n[실패] 포트 ${TARGET_PORT}번 해제에 실패했습니다. PID: ${FINAL_CHECK}"
fi

echo "=========================================="
echo " [진단 및 조치 완료]"
echo "=========================================="

# fuser 명령어로 8080 포트를 점유한 프로세스를 즉시 SIGKILL 종료
sudo fuser -k -9 8080/tcp
sudo fuser -k -9 8005/tcp

# 이후 톰캣 재시작
/opt/tomcat/bin/startup.sh