포트 매핑 문제 디버깅 체크리스트

포트 매핑 문제는 언뜻 단순해 보이지만, 로그를 제대로 읽지 못하면 같은 실수를 반복하게 된다. 애플리케이션이 특정 포트에서 제대로 응답하지 않을 때는 바로 수정하려고 하기보다 재현 조건부터 확인하는 게 낫다.

정상 상태 먼저 정의하기

포트 매핑 문제를 풀 때의 핵심은 정상일 때와 비정상일 때의 로그 차이를 명확히 아는 것이다. 이렇게 하면 같은 상황에서도 빠르게 판단할 수 있다.

확인해야 할 포인트

메모리와 로그는 문제 해결의 가장 빠른 경로다.

• 먼저 볼 값: 로그
• 같이 비교할 값: 정상일 때의 포트 상태
• 남겨둘 기록: 명령 출력, 응답 코드, 수정한 설정

검증 순서

npm run build

설정을 바꿀 때는 한 번에 하나씩만 바꿔야 한다. 여러 개를 동시에 바꾸면 어떤 게 정답인지 알 수 없기 때문이다.

최종 확인

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

다음에 비슷한 증상이 나오면 먼저 현재 값을 기록하고, 하나씩 비교하면 된다. 작은 기록이 쌓이면 문제 해결이 훨씬 빨라진다.