동적 라우트 배포 전 점검 체크리스트

동적 라우트 문제는 로컬에선 괜찮아 보여도 배포 후 툭 터진다. 처음부터 정답을 다 맞히려고 하면 오히려 시간이 훨씬 더 걸린다. 대신 눈에 띄는 증상부터 확인하고, 거기서 원인을 하나씩 좁혀나가는 게 빠르다.

배포 후 첫 번째 확인: 증상 재현하기

먼저 문제가 다시 나는지 확인해야 한다. 로컬과 운영의 차이가 생각보다 크기 때문에, 정상인 상태를 먼저 정해두는 게 중요하다. 예를 들어 특정 동적 경로에서만 404가 나는 건지, 아니면 모든 동적 경로에서 나는 건지 구분해야 한다.

웹 개발 관점에서 확인할 것

동적 라우트 문제는 대부분 한두 가지에서 나온다. 로그와 응답을 함께 보면 원인이 명확해진다.

• 먼저 볼 값: 라우트 정의와 빌드 결과
• 비교할 값: 정상일 때의 라우트 상태
• 남겨둘 기록: 명령 출력, 응답 코드, 수정한 설정

npm run build

문제 해결 순서 정하기

빌드 결과가 애매하면 다른 부분을 고쳐도 결과가 바뀌지 않을 수 있다. 그래서 이 순서를 고정해두면 다음 문제는 훨씬 빨리 해결된다.

1. 원래 증상이 같은 조건에서 다시 나는지 확인한다.
2. 로그나 응답에서 바뀐 부분을 한 줄로 설명해본다.
3. 실제 공개 URL을 열어 최종 확인한다.

실제로는 이 세 단계만으로도 대부분의 동적 라우트 문제를 풀 수 있다. 배포 후 새로운 문제가 나면, 이 순서를 그냥 따라가면 된다.