배포했는데 설정이 다르게 보일 때 원인 찾기

로컬에서 테스트할 땐 완벽했는데, 배포 후엔 설정이 제대로 적용되지 않는 경험이 많다. 이런 상황에선 무작정 코드를 수정하기보다 증거를 모으는 게 먼저다.

먼저 재현 조건을 확인한다

문제가 로컬에서 재현되는지, 배포 환경에서만 발생하는지 구분하는 게 중요하다. 환경별 차이를 메모해두면 나중에 훨씬 빨리 추적할 수 있다. "때때로 발생한다"는 표현보다 "새로고침 후 3회 중 2회 발생" 같은 구체적 조건이 더 도움이 된다.

빌드 결과와 로그를 함께 본다

문제를 해결하기 전에 빌드 로그부터 확인하는 습관이 필요하다.

npm run build

이 명령어에서 경고나 에러가 없는지 확인한다. 빌드는 성공했지만 로그에 뭔가 이상한 메시지가 있다면, 그게 실마리가 될 수 있다.

설정값이 정말 적용되었는지 확인한다

때론 배포 환경 변수를 빠뜨렸거나, CI/CD 스크립트가 제대로 작동하지 않아 이전 버전이 그대로 실행되는 경우도 있다. 실제 서버에서 실행되는 애플리케이션의 설정값을 출력해보고 예상값과 비교하는 과정이 불가결하다.

한 번에 하나씩만 바꾼다

여러 설정을 동시에 수정하면 어느 게 문제 원인인지 알 수 없다. 작은 변경만 적용한 후 배포해서 결과를 확인하는 방식이 시간을 절약한다.

로그와 응답으로 변화를 설명할 수 있어야 한다

"수정했더니 됐다"보다는 "환경 변수를 추가한 후 로그에서 다음 메시지가 사라졌다"는 설명이 훨씬 낫다. 이렇게 기록해두면 다음 번 비슷한 문제 때 빠르게 대응할 수 있다.

마지막 확인으로는 공개 화면, 빌드 결과, 실제 요청 중 하나를 선택해서 최종 검증한다.