[팁]401·403·404·500 오류, 어디부터 확인하면 좋을까요?

오류 화면의 숫자는 원인을 단번에 알려주는 정답은 아니지만, 먼저 살펴볼 범위를 좁혀줍니다. 화면 문구만 보지 말고 실패한 요청의 주소와 상태 코드를 같이 확인해 보세요.

자주 만나는 상태 코드

이 표는 HTTP의 기본 의미를 간략히 정리한 것입니다. 제품별로 실제 오류 처리 방식이 다르므로 코드만 보고 결론을 내리지는 마세요. MDN HTTP 상태 코드 문서를 참고할 수 있습니다.

페이지 오류와 API 오류를 나눕니다

페이지는 200으로 열려도 그 안에서 호출한 API가 401로 실패할 수 있습니다. 반대로 API는 정상인데 화면 코드가 데이터를 처리하지 못할 수도 있습니다. 개발자 도구의 네트워크 목록에서 실제 실패한 요청을 찾는 것이 출발점입니다.

한 번에 하나씩 확인하세요

1. 실패한 요청의 주소, 방법, 상태 코드를 적습니다.
2. 로그인 여부에 따라 달라지는지 비교합니다.
3. 특정 데이터 하나에서만 발생하는지 확인합니다.
4. 직전 배포나 설정 변경과 시점이 맞는지 살펴봅니다.

재시도할 때는 같은 요청을 무작정 여러 번 보내기보다 조건을 하나 바꿔 비교합니다. 글 등록처럼 데이터를 쓰는 요청은 성공 여부가 불분명하면 중복 저장 여부부터 확인하세요.

질문에 남기면 좋은 예시

페이지: /write
동작: 등록 버튼 클릭
실패 요청: POST /게시글-API
상태: 403
비교: 로그인 전에는 401, 로그인 후에는 403
직전 변경: 접근 정책 수정

위 경로는 설명용입니다. 실제 질문에는 자신의 경로를 적되 인증 헤더, 토큰, 개인정보는 제거합니다. 500 오류를 만났다고 이용자 화면에 서버의 원문 로그 전체를 보여주는 것도 피해야 합니다.