배포 후 검색 데이터가 안 보일 때

검색 기능을 배포했는데 데이터가 갑자기 안 보이기 시작하면 황당하다. 하지만 이런 상황일수록 체계적으로 접근해야 한다. 재현 조건을 먼저 정확히 잡으면 원인을 빨리 찾을 수 있다.

문제 해결의 기준

검색 기능 문제를 풀 때 중요한 건 검색 자체보다 재현 가능한 단서를 남기는 것이다. 어떤 검색어에서 문제가 나고, 다른 부분은 정상인지를 명확히 해야 한다.

• 먼저 볼 값: 재현 조건과 사용자 영향 범위
• 같이 비교할 값: 정상일 때의 상태
• 남겨둘 기록: 명령 출력, 응답 코드, 수정한 설정

기본 빌드 확인

npm run build

배포 전 빌드부터 확인하면 불필요한 변경을 줄일 수 있다.

문제 패턴 분석

웹 개발 쪽 문제는 화면만 보고 판단하면 절대 해결되지 않는다. 특정 페이지만 문제인지, 모든 페이지에서 문제인지, 데이터베이스 문제인지를 구분해야 한다.

최종 검증

1. 원래 증상이 같은 조건에서 다시 나는지 확인한다.
2. 로그나 응답에서 바뀐 부분을 한 줄로 설명해본다.
3. 공개 화면, 빌드 결과, 실제 요청 중 하나로 마지막 확인을 한다.

작은 확인을 남겨두면 다음 문제를 훨씬 짧게 처리할 수 있다. 기록이 쌓이면 다음 확인이 훨씬 빨라진다.