kdrug-inventory-system/.claude/flask_process_management.md
시골약사 2a14af59c3 docs: 서버 관리 및 시스템 설계 문서 추가
- Flask 서버 관리 스크립트 (run_server.sh) 추가
- 원산지별 재고 관리 설계 문서 추가
- Flask 프로세스 관리 문서 작성
- 다중 Flask 프로세스 문제 해결 방안 문서화

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>
2026-02-15 09:57:18 +00:00

1.3 KiB

Flask 프로세스 관리 가이드

🚨 문제 상황

  • Flask Debug 모드로 실행 시 코드 변경 시마다 자동 재시작
  • 여러 개의 백그라운드 프로세스가 누적되어 실행됨
  • 동일한 포트(5001)를 여러 프로세스가 점유하려고 시도

해결 방법

1. 즉시 해결 명령어

# 한 줄로 모든 Flask 프로세스 종료 및 재시작
lsof -ti:5001 | xargs -r kill -9 && sleep 2 && source venv/bin/activate && python app.py

2. run_server.sh 스크립트 사용 (이미 생성됨)

./run_server.sh

3. 근본적 해결책

# app.py 수정 - Debug 모드 끄기
app.run(debug=False, host='0.0.0.0', port=5001)

📝 프로세스 확인 명령어

# 포트 5001 사용 중인 프로세스 확인
lsof -i:5001

# 모든 Python 프로세스 확인
ps aux | grep python

# 특정 포트 프로세스만 종료
lsof -ti:5001 | xargs -r kill -9

⚠️ 주의사항

  • Debug 모드는 개발 중에만 사용
  • Production에서는 반드시 debug=False로 설정
  • 코드 변경이 빈번할 때는 수동으로 재시작 권장

🔄 자동화 스크립트

run_server.sh가 이미 생성되어 있음:

  • 기존 프로세스 자동 종료
  • 새 프로세스 시작
  • 단일 프로세스만 실행 보장