서버는 떴는데 404만 난다: 윈도우에서 같은 포트에 파이썬 서버 두 개가 붙는 SO_REUSEADDR 함정
사내 도구(파이썬 HTTP 서버)를 내 윈도우 PC에서 띄웠다. 로그는 「127.0.0.1:8765 시작」인데 API가 전부 404였다. 알고 보니 하루 전에 띄워 둔 python -m http.server 8765가 같은 포트를 잡고 있었고, 새 서버는 오류 없이 같은 포트에 또 붙었다. 파이썬 HTTPServer가 켜는 SO_REUSEADDR이 윈도우에서는 「남이 듣고 있는 포트에도 붙기」를 뜻하기 때문이다. 윈도우에서만 주소 재사용을 끄는 한 줄로, 이제는 포트가 차 있으면 켜질 때 바로 오류가 난다.
배경
- 도구는 파이썬 표준 라이브러리
ThreadingHTTPServer하나로 된 웹 앱이다. 큰 이미지 데이터 묶음 하나를 맡아 화면·메타 정보·타일을 내준다. - 원래는 리눅스 서버에서 돌리고 웹으로 접속해 썼다. 그런데 원격으로는 너무 느렸다.
- 그래서 데이터 묶음(1.7GB)을 PC로 내려받고, 같은 코드를 PC에서 그대로 띄웠다.
증상
1
2
3
4
5
tool server: http://127.0.0.1:8765 ← 서버는 정상 시작 로그
GET / → 200, 8,694 바이트 (도구 화면은 45KB여야 함)
GET /preds → 404 "File not found"
GET /meta → 404
두 가지가 이상했다.
/의 응답 크기가 도구 화면(45KB)이 아니라 8.7KB였다.- 404 페이지가 내 앱의 오류 형식이 아니라 파이썬 표준 404 페이지 모양이었다.
→ 「요청을 받은 게 내 서버가 아니다」라는 신호였다.
진단 과정
1. 서버가 떴는가
로그에 시작 줄이 있고, 프로세스도 살아 있었다. 떠 있다.
2. 누가 그 포트를 듣고 있는가
1
netstat -ano | findstr :8765
LISTENING이 두 줄, PID도 둘이었다.
3. 두 PID는 각각 무엇인가
1
2
Get-CimInstance Win32_Process -Filter "ProcessId=12345" |
Select-Object ProcessId, CreationDate, CommandLine
| PID | 명령줄 | 시작 |
|---|---|---|
| A | python -m http.server 8765 --bind 127.0.0.1 | 전날 저녁(정적 파일 미리보기용) |
| B | python server.py ... --port 8765 | 방금 띄운 도구 |
4. 결론
같은 주소·포트에 두 프로세스가 모두 「듣기」 상태였다. 리눅스였다면 두 번째 프로세스는 Address already in use로 죽었어야 한다. 요청은 먼저 있던 정적 서버로 가서 404가 났다.
원인: SO_REUSEADDR은 OS마다 뜻이 다르다
파이썬 socketserver.TCPServer는 allow_reuse_address가 참이면 바인드 전에 SO_REUSEADDR을 켠다. http.server.HTTPServer(와 이를 상속한 ThreadingHTTPServer)는 이 값이 기본으로 참이다.
| OS | SO_REUSEADDR의 뜻 | 누가 듣고 있는 포트에 bind |
|---|---|---|
| 리눅스·BSD | TIME_WAIT로 남은 옛 연결이 있어도 다시 bind 허용 | 실패 (안전) |
| 윈도우 | 다른 소켓이 쓰고 있어도 같은 주소·포트에 bind 허용 | 성공 (포트 가로채기) |
TIME_WAIT: TCP 연결을 닫은 뒤, 늦게 도착하는 패킷을 처리하려고 소켓이 잠시 남아 있는 상태다. 리눅스에서 서버를 재시작할 때 이 때문에 「이미 사용 중」 오류가 나는 것을 막으려고
SO_REUSEADDR을 쓴다.
윈도우에서는 두 소켓이 같은 포트를 들을 때 어느 쪽이 연결을 받을지 정해져 있지 않다. Microsoft 문서는 이를 막으려면 SO_EXCLUSIVEADDRUSE를 쓰라고 안내한다.
그래서 같은 코드가 리눅스 서버에서는 안전했고, 윈도우 PC에서는 조용히 겹쳤다.
해결
1
2
3
4
5
import os
from http.server import ThreadingHTTPServer
# 윈도우는 포트가 차 있으면 바로 오류가 나게 한다
ThreadingHTTPServer.allow_reuse_address = os.name != "nt"
- HTTP 서버 객체를 만들기 전에 클래스 속성을 바꾼다.
- 이제 윈도우에서 포트가 차 있으면 켜질 때 바로 오류가 난다. 리눅스는 그대로 재사용을 켜 둔다.
- 포트는 8766으로 옮겼다. 남아 있던 미리보기 서버는 쓰는 중일 수 있어서 끄지 않았다.
같이 고친 것: 하드코딩 경로
일부 목록 API가 데이터 경로를 /data/...로 하드코딩하고 있었다. 윈도우에서 /data/...는 오류 없이 「현재 드라이브의 \data」(C:\data\...)로 풀린다. 그래서 빈 목록이 조용히 돌아왔다. 저장소에 이미 있던 경로 모듈(DATA_ROOT 환경변수)을 쓰도록 바꿨다.
대안과 고르지 않은 이유
| 대안 | 고르지 않은 이유 |
|---|---|
| 남아 있던 서버 끄기 | 증상만 없앤다. 다음에 또 겹치면 같은 404를 다시 추적해야 한다 |
SO_EXCLUSIVEADDRUSE 직접 설정 | 윈도우 전용 상수로 소켓을 직접 설정해야 한다. 재사용 끄기 한 줄로 같은 효과를 낸다 |
| 리눅스에서도 재사용 끄기 | 재시작할 때 TIME_WAIT 때문에 수십 초 못 켜는 문제가 생긴다. 리눅스 쪽은 서버를 자주 재시작한다 |
| WSL·도커로 띄우기 | 문제를 피할 뿐이다. 1.7GB 데이터를 또 옮겨야 하고 GPU·파일 경로가 복잡해진다 |
검증
- 8766에서
/는 200(45KB, 도구 화면),/meta·/preds도 200이었다. - 이미지 타일 응답은 17~44ms였다.
- 실제 브라우저로 열어 편집·저장까지 확인했다.
배운 점
같은 이름의 소켓 옵션이 같은 뜻은 아니다
SO_REUSEADDR은 리눅스·BSD에서는 「TIME_WAIT 재사용」, 윈도우에서는 「포트 공유(가로채기)」다. 이름이 같다고 이식성이 있다고 믿으면 안 된다. 파이썬 asyncio의 create_server()가 reuse_address를 유닉스에서만 기본으로 켜는 것도 같은 이유다.
윈도우에서 직접 재현해 볼 수 있다. 터미널 두 개에서 같은 명령을 띄운다.
1
2
3
4
5
# 터미널 1, 2에서 각각
python -m http.server 8765 --bind 127.0.0.1
# 터미널 3: LISTENING이 두 줄 보이면 재현된 것
netstat -ano | findstr :8765
같은 실험을 리눅스에서 하면 두 번째가 OSError: [Errno 98] Address already in use로 끝난다.
「서버가 떴다」와 「내 서버가 답한다」는 다르다
- 응답 크기나 오류 페이지 모양이 예상과 다르면, 코드를 보기 전에 누가 그 포트를 듣는지부터 본다.
- 윈도우는
netstat -ano | findstr :<port>, 리눅스는ss -ltnp | grep :<port>.
개발용 서버는 다음 날의 함정이 된다
python -m http.server 같은 임시 서버를 띄웠으면 끝날 때 끄거나, 어느 포트에 띄웠는지 기록해 둔다.
경로는 한 곳에서만 만든다
/data/... 같은 절대 경로를 하드코딩하면 윈도우에서는 현재 드라이브 기준으로 풀린다. 오류 없이 빈 결과가 나와서 찾기 어렵다. 경로는 환경변수를 읽는 모듈 하나에서만 만든다.
더 찾아볼 키워드: SO_REUSEADDR Windows vs Linux, SO_EXCLUSIVEADDRUSE, SO_REUSEPORT, TIME_WAIT, socketserver allow_reuse_address, asyncio create_server reuse_address