상태 코드(404·500)

쉽게 말하면

이 도장은 화면 어딘가에, 개발자 도구에, 서버 기록에, 그리고 외주 견적서와 연동 문서에 계속 나와요. 숫자를 읽을 수 있으면 상황 파악이 몇 초로 끝나요.

첫 자리가 범인을 가리켜요

세 자리를 다 외울 필요는 전혀 없어요. 첫 자리 하나만 알면 절반은 끝나요.

실제로 자주 보는 숫자들

여기 있는 숫자들이 사장님이 실제로 만날 것의 대부분이에요. 표를 저장해 두고 필요할 때만 보세요.

401과 403의 차이가 헷갈릴 수 있는데, 창구 비유로 보면 간단해요. 401은 "신분증을 안 보여 주셨어요", 403은 "신분증은 봤는데 여기는 직원만 들어갑니다" 예요. 401이면 로그인을 시키고, 403이면 권한 설정을 봐요.

누구 잘못인지 가르는 순서

숫자 하나로 결론을 내면 위험할 때가 있어요. 특히 404는 손님 탓처럼 보이지만 사장님 탓인 경우가 아주 많아요. 이 순서로 확인하면 헛수고를 줄여요.

1. 1나도 같은 화면에서 같은 숫자가 나오나 봐요. 나만 잘 되면 손님 쪽 기기·연결 문제일 수 있어요. 나도 나오면 서비스 문제예요.
2. 2400대면 무엇을 요청했는지 봐요. 눌린 버튼, 넣은 값, 로그인 여부를 확인해요. 404라면 그 주소를 어디서 알려 줬는지가 핵심이에요. 내가 만든 버튼이 없는 주소로 보내고 있으면 그건 내 잘못이에요.
3. 3500대면 요청은 건드리지 않아요. 같은 요청을 몇 번 더 해 봐도 500이 나오면 서버 쪽이 확실해요. 서버 기록을 보거나, 결제사처럼 남의 서버를 쓰고 있다면 그 회사 장애 공지를 확인해요.
4. 4언제부터 그랬는지 적어요. 방금 배포한 뒤부터라면 되돌리는 게 가장 빠른 해결이에요.
5. 5같은 숫자가 반복되면 기록으로 남겨요. 몇 시에, 어느 화면에서, 어떤 숫자였는지 세 줄만 있어도 원인 찾기가 확 빨라져요.

손님에게 보여 줄 화면은 두 장이면 돼요

숫자를 알아본 다음에 할 일은 딱 하나예요. 404 화면과 500 화면, 두 장만 만들어 두는 것. 나머지 숫자는 이 두 장 중 하나로 흘려보내도 손님은 불편하지 않아요.

404 화면에는 돌아갈 길을 두세요. 홈 버튼과 인기 메뉴 몇 개면 충분해요. 500 화면에는 다시 시도할 길과 연락처를 두세요. 손님 잘못이 아니니 사과 한 줄을 먼저 쓰는 게 좋아요. 만드는 방법은 오류 화면에 자세히 있어요.

AI에게 그대로 말할 문장

숫자를 알면 부탁하는 문장이 짧고 정확해져요. 아래 문장을 그대로 옮겨 쓰세요. 원인을 짐작해서 말하지 말고 본 것만 말하는 게 요령이에요.

마지막 줄이 은근히 강력해요. 숫자가 안 보이는 서비스는 고치기가 몇 배 어려워요. 실패할 때 숫자와 시각이 남게 만들어 두면 그다음 모든 문제가 쉬워져요. 자세한 요령은 에러 읽는 법과 오류 화면에 있어요.

견적서와 연동 문서를 읽는 힘

이 숫자들을 알면 외주 견적서와 연동 문서가 갑자기 읽혀요. 저쪽 말에 휘둘리지 않으려면 이 표현들을 알아야 해요.

지금은 신경 쓰지 않아도 되는 때

정직하게 말하면, 숫자를 알아보는 것 이상은 대부분의 사장님에게 지금 할 일이 아니에요. 손님이 하루 열 명인 가게에서 상태 코드 관리 체계를 세우는 건 시간 낭비예요.

자주 묻는 것

Q. 이 숫자를 제가 직접 정해야 하나요?

아니에요. 서버가 알아서 찍어 주는 도장이에요. 사장님이 할 일은 만났을 때 알아보는 것뿐이에요. 다만 만든 서비스가 404나 500을 만났을 때 손님에게 보여 줄 화면은 정해 두는 게 좋아요.

Q. 화면에는 숫자가 안 보이는데 어디서 봐요?

요즘 서비스는 숫자 대신 "문제가 생겼어요" 같은 말만 보여 주기도 해요. 브라우저의 개발자 도구를 열면 요청마다 숫자가 보여요. 방법은 브라우저 점검 도구에 있어요. 눈으로 보기 어려우면, 실패할 때 화면에 숫자를 함께 띄우게 AI에게 부탁하세요.

Q. 404가 검색 순위에 나쁜가요?

손님이 실제로 밟는 404가 많으면 안 좋아요. 특히 검색 결과에 올라간 페이지를 지워서 생긴 404가 그래요. 페이지를 없앨 때는 새 주소로 안내하는 300대 도장을 남기는 게 정석이에요.

Q. 500을 제가 고칠 수 있어요?

내 서비스 안에서 난 500은 고칠 수 있어요. 원인이 코드나 설정에 있으니까요. 반대로 결제사나 지도 서비스처럼 남의 서버에서 난 500은 기다리는 게 답이에요. 그 회사 장애 공지를 확인하고, 손님에게는 잠시 뒤 다시 시도해 달라고 안내하세요.

Q. 502와 503은 뭐가 달라요?

둘 다 "뒤쪽이 지금 답을 못 준다"예요. 502는 창구가 주방에 물었는데 이상한 답이 온 것, 503은 주방이 문을 닫아 놓은 것에 가까워요. 사장님 대응은 같아요. 점검이나 배포 중이 아닌지 확인하고, 아니면 기록을 봐요.

Q. 개발자가 "그건 사장님 쪽 4xx예요"라고 하면 받아들여야 하나요?

숫자만으로 책임이 정해지지는 않아요. 400대는 요청이 잘못됐다는 뜻이지만, 그 요청을 만든 게 개발자가 만든 화면이면 결국 그쪽 일이에요. "어느 화면의 어느 버튼이 그 요청을 보냈나요"라고 되물으세요. 이 질문 하나로 대화가 정리돼요.

Q. 숫자가 여러 개 섞여 나와요. 어디부터 봐요?

500대부터 보세요. 서버가 아픈 상태에서는 400대도 같이 늘어나요. 서버를 세워 놓고 다시 보면 400대 중 상당수가 저절로 사라져 있어요.

Q. 손님에게는 이 숫자를 보여 줘야 하나요?

숫자만 덩그러니 보여 주면 손님은 겁만 먹어요. 손님에게는 무엇을 하면 되는지를 말로 알려 주고, 숫자는 작게 곁들이는 정도가 좋아요. 사장님에게 제보할 때 그 숫자가 단서가 되니까요.

확인해 보세요