앱 버전 업데이트 후 문제가 터졌을 때

앱 버전을 올린 후 문제가 터질 때는 두 가지 질문을 먼저 한다: 무엇이 바뀌었는가? 그 변화가 실제 영향을 주는가?

많은 경우 변경했던 코드와 실제 배포된 결과가 다르다. 로컬에서는 잘 작동했는데 서버에서 실패하는 이유도 여기에 있다. 빌드 프로세스가 뭔가를 놓쳤을 수 있다.

빌드 결과부터 확인하기

어떤 코드를 변경했든, 실제로 배포되는 것은 빌드된 결과물이다. 로컬에서 코드를 수정했다고 해서 그것이 정확히 서버에 반영되는 건 아니다.

npm run build

빌드 후 성공했는지 확인하고, 결과물의 크기나 생성된 파일들이 이전과 어떻게 달라졌는지 본다. 빌드 에러가 조용히 무시될 수도 있으니 주의 깊게 봐야 한다.

사용자에게 실제로 영향이 가는가

코드는 바뀌었지만 사용자 입장에서는 아무것도 달라지지 않았을 수도 있다. 캐시 때문일 수도, 배포가 제대로 되지 않았을 수도 있다.

변경한 기능을 직접 테스트해본다. 예를 들어 특정 버튼을 눌렀을 때 다른 동작이 나타나야 한다면, 그 버튼을 직접 눌러본다. 결과가 예상한 것과 다르다면 그때부터 원인을 파고든다.

응답 코드와 로그로 원인 찾기

사용자에게는 보이지 않지만, 브라우저 개발자 도구나 서버 로그에는 힌트가 숨어 있다. API 응답 코드, 네트워크 요청, 콘솔 에러를 모두 모아야 한다.

특히 버전 업데이트 후에는 이전 빌드 결과와 새 빌드 결과를 비교해보는 것도 효과적이다. 어떤 파일이 추가되었고, 어떤 파일이 삭제되었으며, 어떤 파일이 수정되었는지 확인한다.

체크리스트

새 버전 배포 후 문제를 다룰 때는 이 순서를 따른다:

1. 로컬에서 npm run build를 실행하고 성공 여부를 확인한다
2. 빌드된 파일이 예상과 일치하는지 본다
3. 실제 사용자 영향이 있는지 테스트한다
4. 브라우저 콘솔과 네트워크 탭에서 에러를 찾는다
5. 이전 버전과 현재 버전을 비교한다

결과가 바뀐 이유를 로그와 응답으로 설명할 수 있으면 충분히 정리된 것이다. 관련 기록을 남겨두면 다음 버전 업데이트 때 훨씬 빠르게 대응할 수 있다.