Prisma + Docker PostgreSQL 연결 오류 해결 (Windows)

Prisma + Docker PostgreSQL 연결 오류 해결 (Windows)

문제 상황

pnpm prisma db push로 Prisma 마이그레이션 실행 시 아래 에러 발생

Error: P1000: Authentication failed against database server, 
the provided database credentials for `(not available)` are not valid.

원인

로컬에 설치된 PostgreSQL이 5432 포트를 선점하고 있어서 Prisma가 Docker 컨테이너가 아닌 로컬 PostgreSQL로 연결을 시도했기 때문.

진단 방법

1. .env 확인 -> docker-compose 확인
   -> docker-compose down -v ->volume 삭제->컨테이너 재실행(docker-compose up -d)
2. 포트 점유 프로세스 확인
   bashnetstat -ano | findstr :5432
   두 개 이상의 PID가 나오면 포트 충돌.

해결 방법

docker-compose.yml 포트 변경 (5432 → 5433)

간단한 문제였다. docker ps를 했을 때 아무것도 안 보여서 같은 포트를 쓰고 있는 게 없는 줄 알았는데 그게 패착이었다.
docker ps는 Docker 컨테이너 목록만 보여줄 뿐 로컬에 설치된 PostgreSQL 같은 네이티브 프로세스는 보이지 않는다.
다음번에 이런 일이 생기면 포트 점유 프로세스부터 확인하자.