ai-coding-mines목차GitHub

`requirements.txt` 누락 → 무증상 롤백

배포 · 인프라

증상

새로 추가한 라우트만 404. 앱 자체는 정상(다른 라우트 전부 200). git push 성공, 원격에 파일도 등록줄도 존재, 서버에서 로컬 import도 통과. 8분을 기다려도 404.

원인

requirements.txtrequests가 없었다. 클린 빌드에서 새 모듈 import 실패 → 앱 기동 실패 → PaaS가 직전 성공 빌드로 계속 서비스했다. 그래서 "앱은 멀쩡한데 새 라우트만 없는" 상태가 된다.

왜 놓치기 쉬운가

기존 코드가 이미 requests를 쓰는데도 requirements에 없었다. 기존 컨테이너에 캐시로 남아 돌고 있었을 뿐이고, 클린 빌드에서만 터진다.

철칙

  1. 새 모듈 추가 시 import 목록과 requirements.txt대조한다
  2. 배포 후 새 라우트가 404면 가장 먼저 의존성을 의심한다 (커밋 유실이 아니다)
  3. push 성공 메시지는 배포 성공의 증거가 아니다. 실 URL로 친다
  4. 로컬 import 성공은 배포 성공의 증거가 아니다