fix: uvicorn 미설치로 dashboard 실패 + 오해의 소지 있는 시작 로그 #178

Closed
opened 2026-02-20 08:51:07 +09:00 by agentson · 0 comments
Collaborator

문제

1. uvicorn 미설치

pyproject.tomluvicorn>=0.29,<1이 의존성으로 명시되어 있으나 실제로 설치되지 않음.
--dashboard 플래그 사용 시 dashboard가 묵묵히 실패함.

Dashboard server failed to start: No module named 'uvicorn'

2. 오해의 소지 있는 로그 순서 (main.py:1324-1329)

thread가 실제로 시작하기 전에 "Dashboard server started" 로그가 기록됨.
실패 시 사용자는 "started" 다음 "failed"를 보게 되어 혼란스러움.

thread.start()         # 여기서 실패 발생 가능
logger.info("Dashboard server started at ...")  # 항상 출력됨 (잘못됨)

재현 방법

python3 -m src.main --mode=paper --dashboard

영향

  • Dashboard가 완전히 비활성화됨 (포트 8080 미응답)
  • 사용자가 실패를 즉시 인지하지 못함

수정 방법

  1. pip install uvicorn 또는 pip install -e .[dev] 실행 확인
  2. main.py의 로그 순서 수정: 스레드 실제 시작 성공 후에 "started" 로그 출력

테스트

  • --dashboard 플래그 포함 실행 시 http://localhost:8080 응답 확인
  • uvicorn 없을 때 명확한 오류 메시지 출력 확인
## 문제 ### 1. uvicorn 미설치 `pyproject.toml`에 `uvicorn>=0.29,<1`이 의존성으로 명시되어 있으나 실제로 설치되지 않음. `--dashboard` 플래그 사용 시 dashboard가 묵묵히 실패함. ``` Dashboard server failed to start: No module named 'uvicorn' ``` ### 2. 오해의 소지 있는 로그 순서 (`main.py:1324-1329`) thread가 실제로 시작하기 전에 `"Dashboard server started"` 로그가 기록됨. 실패 시 사용자는 "started" 다음 "failed"를 보게 되어 혼란스러움. ```python thread.start() # 여기서 실패 발생 가능 logger.info("Dashboard server started at ...") # 항상 출력됨 (잘못됨) ``` ## 재현 방법 ```bash python3 -m src.main --mode=paper --dashboard ``` ## 영향 - Dashboard가 완전히 비활성화됨 (포트 8080 미응답) - 사용자가 실패를 즉시 인지하지 못함 ## 수정 방법 1. `pip install uvicorn` 또는 `pip install -e .[dev]` 실행 확인 2. `main.py`의 로그 순서 수정: 스레드 실제 시작 성공 후에 "started" 로그 출력 ## 테스트 - `--dashboard` 플래그 포함 실행 시 `http://localhost:8080` 응답 확인 - uvicorn 없을 때 명확한 오류 메시지 출력 확인
Sign in to join this conversation.
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: jihoson/The-Ouroboros#178