(번외) Alembic ‘Target database is not up to date’ 오류 원인 진단

📘 문제(Problem) – Alembic 마이그레이션 오류 분석

다음은 Python FastAPI + SQLAlchemy + Alembic을 사용하여 SQLite 데이터베이스를 설정하던 중 발생한 실제 콘솔 출력이다.

---

[지문]

개발자는 SQLite 데이터베이스(myapi.db)와 Alembic을 이용해 모델을 마이그레이션하려고 한다.
그러나 다음과 같은 오류가 반복적으로 발생하였다.

 

$ alembic revision --autogenerate -m "init" INFO [alembic.runtime.migration] Context impl SQLiteImpl. INFO [alembic.runtime.migration] Will assume non-transactional DDL. ERROR [alembic.util.messaging] Target database is not up to date. FAILED: Target database is not up to date.

또한 개발자가 DB 파일을 삭제한 후에도 동일한 오류가 나타났다.

개발 환경의 주요 파일 구조는 다음과 같다.

~/Documents/FastAPI/ 
├─ alembic.ini 
├─ migrations/ 
│ ├─ versions/ 
│ │ └─ (이전에 생성된 migration 파일들 존재) 
├─ models.py 
├─ database.py 
└─ myapi.db

Alembic 설정(env.py)에서는 다음과 같이 모델의 메타데이터를 불러오고 있다.

 

from models import Base target_metadata = Base.metadata

데이터베이스 URL은 다음과 같다.

 

SQLALCHEMY_DATABASE_URL = "sqlite:///./myapi.db"

 

개발자는 DB 파일(myapi.db)을 삭제했으나, Alembic은 계속 동일한 오류를 출력하였다.
마지막으로 다음 코드로 Alembic이 실제로 읽는 DB 파일 경로를 확인했다.

 

abs_path = os.path.abspath("./myapi.db") 
print(abs_path, os.path.exists(abs_path))
그 결과 다음 출력이 나왔다.

 

 

/home/tkddus21/Documents/FastAPI/myapi.db 존재 여부: True

---

[문제]

1) 위 상황에서 Alembic이 "Target database is not up to date"를 출력한 이유를 기술하시오.

2) 개발자가 단순히 DB 파일을 삭제했음에도 불구하고 Alembic이 계속 오류를 출력한 근본 원인을 설명하시오.

3) 이 문제를 해결하기 위해 개발자가 수행해야 했던 정확한 조치(명령어 포함)를 작성하시오.