패키지 충돌로 사용자 입력이 막힐 때

갑자기 사용자의 폼 입력이 먹통이 되는 상황을 경험했다. 로컬에서는 문제가 없는데 배포된 환경에서만 발생했다. 처음엔 패키지 버전 충돌인 줄 알았는데 알고 보니 설정 문제였다.

문제 해결 과정에서 로컬과 운영 환경의 차이를 함께 적어두면 다음 확인이 훨씬 쉬워진다.

사용자가 보는 증상 정리하기

개발자가 보는 에러와 사용자가 보는 증상은 다르다. 먼저 사용자 관점에서 무엇이 잘못 됐는지 명확히 파악해야 한다.

• 사용자 영향도
• 정상일 때와의 비교
• 기록할 사항: 명령어 출력, 상태 코드, 수정 내용

로그에서 신호 찾기

바로 코드를 수정하기 전에 로그를 자세히 봐야 한다. 에러 메시지가 명확하면 원인 후보를 빠르게 좁힐 수 있다.

npm run build

한 가지씩 확인하기

1. 같은 조건에서 문제 재현
2. 로그와 응답의 변화 기록
3. 공개 환경에서 최종 테스트

해결 자체보다 어떤 값이 달라졌는지 설명할 수 있는 상태가 더 중요하다. 그 상태를 기록해두면 다음 문제는 훨씬 빠르게 처리할 수 있다.