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

48 lines
1.3 KiB
Markdown

# Flask 프로세스 관리 가이드
## 🚨 문제 상황
- Flask Debug 모드로 실행 시 코드 변경 시마다 자동 재시작
- 여러 개의 백그라운드 프로세스가 누적되어 실행됨
- 동일한 포트(5001)를 여러 프로세스가 점유하려고 시도
## ✅ 해결 방법
### 1. 즉시 해결 명령어
```bash
# 한 줄로 모든 Flask 프로세스 종료 및 재시작
lsof -ti:5001 | xargs -r kill -9 && sleep 2 && source venv/bin/activate && python app.py
```
### 2. run_server.sh 스크립트 사용 (이미 생성됨)
```bash
./run_server.sh
```
### 3. 근본적 해결책
```python
# app.py 수정 - Debug 모드 끄기
app.run(debug=False, host='0.0.0.0', port=5001)
```
## 📝 프로세스 확인 명령어
```bash
# 포트 5001 사용 중인 프로세스 확인
lsof -i:5001
# 모든 Python 프로세스 확인
ps aux | grep python
# 특정 포트 프로세스만 종료
lsof -ti:5001 | xargs -r kill -9
```
## ⚠️ 주의사항
- Debug 모드는 개발 중에만 사용
- Production에서는 반드시 debug=False로 설정
- 코드 변경이 빈번할 때는 수동으로 재시작 권장
## 🔄 자동화 스크립트
run_server.sh가 이미 생성되어 있음:
- 기존 프로세스 자동 종료
- 새 프로세스 시작
- 단일 프로세스만 실행 보장