Prisma로 로컬 DB 설정 확인하는 순서

로컬 개발 환경에서 DB 문제가 나면 대부분 세 가지 중 하나다: 연결 문제, 스키마 문제, 마이그레이션 상태 문제. 각각을 체계적으로 확인하면 시간을 많이 절약할 수 있다.

DATABASE_URL 확인

먼저 환경 변수가 제대로 설정돼 있는지 본다.

echo $DATABASE_URL  # 또는 .env 파일에서 직접 확인

로컬 개발이면 보통 SQLite를 쓰는데, 경로가 맞아야 한다:

DATABASE_URL="file:./dev.db"

Prisma 스키마 검증

npx prisma validate

이 명령어로 schema.prisma 파일의 문법과 타입을 확인한다. 에러가 나면 해당 줄을 수정하면 된다.

마이그레이션 상태 확인

npx prisma migrate status

이 명령어의 결과로 다음 중 하나가 나온다:

• "Migrations are up to date" - 모두 적용됨
• 적용 안 된 마이그레이션 목록 - npx prisma migrate deploy로 적용
• "Database does not exist" - npx prisma migrate deploy로 생성

강제 리셋 필요할 때

로컬 개발 중에 DB를 완전히 초기화하고 싶으면:

npx prisma migrate reset

이 명령어는 DB를 드롭하고 다시 생성한 후 모든 마이그레이션을 적용한다.

실제 데이터 확인

Prisma Studio로 데이터를 시각적으로 확인할 수도 있다:

npx prisma studio

로컬 개발 중에는 이 도구가 데이터가 제대로 들어가 있는지 빠르게 확인하는 데 도움이 된다.