인덱스 배포 후 데이터가 안 보일 때

인덱스를 배포한 후 갑자기 데이터가 조회되지 않을 수 있다. 처음부터 정답을 맞히려고 하면 오히려 확인 시간이 길어진다. 문제를 몇 가지 카테고리로 나누고, 하나씩 제외해가며 좁혀야 한다.

DB 문제는 화면만 보고 판단할 수 없다. 실제 쿼리가 실행되는지, 권한은 맞는지, 인덱스가 제대로 생성됐는지 여러 각도에서 봐야 한다.

왜 헷갈리는가

DB 문제를 좁히려면 권한부터 확인해야 한다. 화면만 보고 판단하면 놓치는 값이 많다. 로그, 응답, 설정 중 하나를 증거로 잡아야 한다.

재현 조건 정하기

먼저 같은 조건에서 문제가 다시 나오는지 확인한다. 문제가 일정하게 재현되는지 랜덤하게 나타나는지에 따라 확인 방법이 달라진다.

• 먼저 볼 것: 권한, 스키마
• 비교할 값: 정상일 때의 DB 상태
• 남길 기록: 명령어 출력, 오류 메시지, 수정한 설정

스키마와 인덱스 확인

데이터 계층의 흐름을 먼저 끊어서 봐야 한다. DATABASE_URL이 애매하면 다른 부분을 고쳐도 결과가 바뀌지 않을 수 있다.

npx prisma validate
npx prisma migrate status

로컬과 운영 환경이 다른 DB를 가리키고 있지 않은지 확인하자.

최종 확인

백업 상태를 먼저 확인해야 문제가 나은 후에도 원상복구할 수 있다.

확인 순서:

1. 같은 조건에서 변경을 다시 시도한다
2. 로그나 응답에서 달라진 부분을 설명한다
3. 공개 화면, 빌드 결과, 실제 요청으로 확인한다

정리

한 번에 여러 설정을 바꾸지 않는 것만으로도 원인 추적이 쉬워진다. 관련 기록을 남겨두면 다음 확인이 훨씬 빨라진다.