콘솔에 404, 500 이런 숫자 떴는데 이게 뭔가요?

AI가 만들어준 기능을 테스트하다가 화면은 하얗고, 개발자도구 콘솔에는 404나 500 같은 빨간 숫자만 떠 있어서 뭘 어떻게 고쳐야 할지 막막했던 적 있으신가요?

한 줄 정의

HTTP 상태코드는 서버가 "네 요청 어떻게 처리했어"를 세 자리 숫자로 알려주는 신호입니다.

왜 필요한가

에러 메시지가 다 "안 됨"이라고만 뜨면 뭐가 문제인지 알 수가 없습니다. 그래서 서버는 "네가 잘못 물어봤어(4xx)"인지 "내가(서버가) 고장났어(5xx)"인지, 아니면 "잘 처리됐어(2xx)"인지를 숫자로 구분해서 알려줍니다.

실전에서 이렇게

404가 뜨면 "주소를 잘못 찾아갔다"는 뜻이라 API 경로 오타나 라우트 설정을 먼저 의심하면 되고, 500이 뜨면 "서버 코드 안에서 에러가 났다"는 뜻이라 AI에게 "500 에러인데 서버 로그 좀 봐줘"라고 하면 훨씬 빠르게 원인을 찾습니다. 401이나 403이 뜨면 로그인이나 권한 문제일 확률이 높습니다.

비유

택배를 시켰는데 상황별로 다른 문자가 오는 것과 같습니다. "주소가 잘못됐어요"(404), "물건은 찾았는데 창고에서 사고가 났어요"(500), "본인 확인이 안 돼서 못 보내요"(401). 숫자만 봐도 어디서부터 고쳐야 할지 감이 잡힙니다.