파이썬 에러 해결하기: 'Address already in use' 오류 완벽 정복

소켓 프로그래밍이나 웹 서버 개발을 하다 보면 자주 마주치는 'Address already in use' 에러는 개발자를 당황스럽게 만듭니다. 이 글에서는 이 에러의 원인부터 해결 방법까지 상세히 알아보겠습니다.

'Address already in use' 에러란 무엇인가?

'Address already in use' 에러는 파이썬에서 소켓을 사용할 때 발생하는 대표적인 오류입니다. 정확히는 OSError: [Errno 98] Address already in use 형태로 나타납니다. 이 에러는 이미 사용 중인 포트에 새로운 소켓을 바인딩하려고 할 때 발생합니다.

import socket

server_socket = socket.socket(socket.AF_INET, socket.SOCK_STREAM)
server_socket.bind(('localhost', 8000))  # 이미 사용 중인 포트라면 에러 발생

에러의 주요 원인

'Address already in use' 에러가 발생하는 흔한 원인은 다음과 같습니다:

이전 프로그램이 계속 실행 중: 같은 포트를 사용하는 프로세스가 아직 종료되지 않았을 때
TIME_WAIT 상태: 소켓이 완전히 닫히기 전 대기 상태에 있을 때
다른 애플리케이션의 포트 사용: 다른 프로그램이 해당 포트를 이미 점유하고 있을 때

에러 해결 방법

1. 실행 중인 프로세스 확인 및 종료

가장 먼저 해당 포트를 사용 중인 프로세스를 확인하고 종료하는 방법입니다.

# 리눅스/맥 환경
lsof -i :8000
kill -9 [PID]

# 윈도우 환경
netstat -ano | findstr :8000
taskkill /PID [PID] /F

2. SO_REUSEADDR 옵션 설정

파이썬 코드에서 SO_REUSEADDR 옵션을 설정하면 TIME_WAIT 상태의 소켓을 재사용할 수 있습니다.

import socket

server_socket = socket.socket(socket.AF_INET, socket.SOCK_STREAM)
server_socket.setsockopt(socket.SOL_SOCKET, socket.SO_REUSEADDR, 1)
server_socket.bind(('localhost', 8000))

3. 다른 포트 사용하기

가장 간단한 해결책은 다른 포트를 사용하는 것입니다.

import socket

server_socket = socket.socket(socket.AF_INET, socket.SOCK_STREAM)
server_socket.bind(('localhost', 8001))  # 다른 포트 번호 사용

Flask나 Django에서의 해결 방법

웹 프레임워크를 사용할 때도 같은 에러가 발생할 수 있습니다.

Flask 예제

from flask import Flask

app = Flask(__name__)

@app.route('/')
def home():
    return "Hello, World!"

if __name__ == '__main__':
    app.run(host='0.0.0.0', port=8000, debug=True)
    # 에러 발생 시: app.run(host='0.0.0.0', port=8001, debug=True)로 변경

Django 예제

Django의 runserver 명령어 사용 시 포트를 변경할 수 있습니다.

python manage.py runserver 8001  # 기본 8000에서 8001로 변경

프로그램적으로 사용 가능한 포트 찾기

자동으로 사용 가능한 포트를 찾아 할당하는 방법도 있습니다.

import socket

def find_free_port():
    sock = socket.socket(socket.AF_INET, socket.SOCK_STREAM)
    sock.bind(('', 0))
    port = sock.getsockname()[1]
    sock.close()
    return port

# 사용 예
port = find_free_port()
print(f"사용 가능한 포트: {port}")

정리

'Address already in use' 에러는 네트워크 프로그래밍에서 흔히 발생하는 문제지만, 원인을 이해하고 적절한 해결책을 적용하면 쉽게 해결할 수 있습니다. 가장 효과적인 방법은 SO_REUSEADDR 옵션을 사용하는 것이며, 상황에 따라 포트 변경이나 프로세스 종료 방법을 활용할 수 있습니다.

소켓 프로그래밍을 할 때는 항상 이러한 네트워크 리소스 관리에 신경 쓰는 것이 중요합니다. 오류가 발생했을 때 당황하지 말고 적절한 해결책을 찾아 적용해보세요.

Arong's Town

이 블로그 검색