502 에러가 났을 때 먼저 볼 로그

처음부터 정답을 맞히려고 하면 오히려 디버깅 시간이 더 길어진다. 502 에러는 웹 서버와 애플리케이션 서버 사이의 통신 문제인데 원인이 많다.

먼저 재현 가능한 상태를 만들고, 그 상태에서 무엇이 달라졌는지 확인하는 게 체계적인 접근이다.

핵심 질문부터 시작하기

언제부터 에러가 시작됐는지, 어떤 요청에서 나타나는지 먼저 정해야 한다. "항상 502 에러"보다 "특정 경로에서만 502"가 훨씬 추적하기 쉽다.

• 메타 정보 확인: sitemap, RSS
• 정상일 때의 렌더링 상태
• 기록할 사항: 명령어 출력, 상태 코드, 설정 변경사항

실제 응답 확인해보기

캐시되지 않은 실제 응답을 확인해보자. 브라우저 개발자 도구나 curl로 직접 요청해서 응답을 본다.

curl -s https://example.com | grep -Ei 'title|description|canonical|og:|twitter:'
npm run build

예상 상태 vs 실제 상태

1. 같은 조건에서 에러가 반복되는지 확인
2. 로그와 응답에서 변화를 한 줄로 정리
3. 공개 환경에서 최종 확인

마지막에는 실제 화면이나 공개 URL까지 확인해야 작업이 완료된다.