에러 읽는 법
빨간 글씨는 혼내는 게 아니라 어디가 막혔는지 알려주는 쪽지예요. 읽는 법만 알면 무섭지 않고, 오히려 가장 빠른 단서예요.
쉽게 말하면
주방에서 "양파 떨어졌어요"라고 외치는 것과 같아요. 혼내는 말이 아니라 무엇이 없어서 못 하고 있는지 알려주는 말이에요. 양파를 채우면 다시 돌아가요. 에러도 똑같아요. 무엇이 없거나 안 맞는지를 알려주는 쪽지예요.
많은 사장님이 빨간 글씨를 보면 창을 닫아 버려요. 그런데 그 글씨 안에 답이 들어 있는 경우가 대부분이에요. 무서워 보일 뿐이지 사실 가장 친절한 안내문입니다.
자주 보는 것들
| 이런 글씨 | 무슨 뜻 | 사장님이 할 일 |
|---|---|---|
| 404 · 찾을 수 없음 | 그 주소에 아무것도 없어요. 주소를 잘못 쳤거나 페이지가 지워졌어요 | 주소를 다시 확인하세요. 링크를 손님에게 보냈다면 그 링크를 확인하세요 |
| 500 · 서버 오류 | 주방 안에서 뭔가 잘못됐어요. 손님 잘못이 아니에요 | 잠시 뒤 다시 해보고, 계속되면 최근에 고친 것을 되돌려 보세요 |
| 연결할 수 없음 | 주방까지 말이 안 닿아요 | 호스팅이 살아 있는지, 요금이 밀리지 않았는지 확인하세요 |
| 권한이 없습니다 | 들어갈 자격이 확인 안 됐어요 | 로그아웃했다 다시 로그인해 보세요. 키가 만료됐을 수도 있어요 |
| 시간이 초과됐습니다 | 너무 오래 걸려서 기다리다 포기했어요 | 사진이 너무 무겁거나 한 번에 너무 많은 걸 시켰을 때 나요 |
숫자를 기억해 두세요
400번대는 요청한 쪽 문제, 500번대는 받는 쪽 문제예요. 404는 400번대니 주소가 잘못된 것이고, 500은 서버 안에서 난 일이라 손님이 뭘 해도 안 됩니다. 이 구분만 알아도 어디를 봐야 할지가 절반은 정해져요.
읽는 순서
에러 글씨는 보통 길어요. 전부 읽을 필요는 없고 순서가 있습니다.
- 1맨 윗줄 한 줄만 읽어요. 거기에 무엇이 잘못됐는지가 적혀 있어요. 아래는 대부분 기술적인 경로라 사장님이 볼 것이 아니에요.
- 2파일 이름과 줄 번호를 찾아요. 어디서 막혔는지 위치가 적혀 있어요. 개발자에게 물어볼 때 이 부분을 함께 보내면 대화가 열 배 빨라져요.
- 3직전에 뭘 했는지 떠올려요. 방금 고친 것이 원인인 경우가 압도적으로 많아요. 되돌리면 살아나는지 먼저 확인해요.
- 4그대로 복사해서 AI에게 보여줘요. 이게 가장 빠릅니다. 요약하지 말고 통째로 붙여넣으세요.
요약하지 마세요
"에러가 났어요"라고만 하면 아무도 못 도와줘요. 글씨를 그대로 복사해서 보여주는 것이 사장님이 할 수 있는 가장 강력한 행동이에요. 개발자에게도, AI에게도 마찬가지예요.
사장님이 실제로 겪는 장면
장면 1 · 손님이 404를 봤다고 한다
“손님이 링크 눌렀더니 404가 떴대요. 저는 잘 되는데요.”
손님이 받은 링크 자체를 받아서 눌러 보세요. 링크가 잘리거나 오타가 섞여 전달된 경우가 많아요. 카톡이나 문자에서 주소 끝이 잘리는 일이 흔합니다. 링크는 짧을수록 안전해서 도메인을 붙이면 이런 사고가 줄어요.
장면 2 · 어제까지 잘 되던 게 오늘 안 된다
“저는 아무것도 안 건드렸는데 오늘 갑자기 안 돼요.”
정말 아무것도 안 건드렸다면 바깥에서 온 원인이에요. 만료된 키, 끊긴 요금, 연결한 다른 회사 서비스의 장애 같은 것이요. 에러 글씨를 보면 어느 쪽인지 대개 적혀 있어요.
자주 묻는 것
- Q. 에러가 나면 제가 뭘 잘못한 건가요?
- 대부분 아니에요. 설정이 안 맞거나, 연결이 끊겼거나, 뭔가 없어서 나는 거예요. 자책하지 말고 쪽지를 읽으세요.
- Q. 빨간 글씨를 손님도 보나요?
- 종류에 따라 달라요. 404 같은 건 손님도 봅니다. 그래서 손님이 봐도 당황하지 않을 안내 화면을 준비해 두는 게 좋아요.
- Q. 에러를 AI에게 보여줘도 되나요?
- 네, 그게 가장 빠른 방법이에요. 다만 에러 글씨 안에 비밀키가 섞여 있으면 그 부분은 지우고 보내세요.
- Q. 경고와 에러는 다른가요?
- 달라요. 에러는 멈춘 것이고, 경고는 돌아가긴 하는데 나중에 문제가 될 수 있다는 알림이에요. 급한 건 에러부터입니다.
확인해 보세요
손님 화면에 500 오류가 떴어요. 어느 쪽 문제일까요?
하나 더
에러가 났어요. 도움을 청할 때 가장 좋은 방법은?
더 깊이 (안 읽어도 괜찮아요)
숫자에 규칙이 있어요 · 200번대는 잘 됐다는 뜻이고(평소엔 안 보여요), 300번대는 다른 곳으로 옮겨 갔다는 뜻, 400번대는 요청한 쪽 문제, 500번대는 받는 쪽 문제예요. 이 네 자리만 알면 처음 보는 숫자도 대충 짐작이 됩니다.
손님용 404 화면을 준비해 두기 · 주소가 잘못됐을 때 나오는 화면을 꾸며 둘 수 있어요. "찾으시는 페이지가 없어요. 메뉴로 돌아가기" 같은 안내를 넣으면 손님이 그냥 나가지 않아요. 실제로 손님을 붙잡는 효과가 있는 작은 준비예요.
에러가 안 나는 게 항상 좋은 건 아니에요 · 조용히 잘못되는 것보다 시끄럽게 멈추는 게 나아요. 예약이 저장 안 됐는데 저장됐다고 뜨는 것보다, 에러가 나서 사장님이 아는 편이 훨씬 낫거든요.
이것만 기억하세요
- ·에러는 혼내는 말이 아니라 무엇이 막혔는지 알려주는 쪽지예요
- ·400번대는 요청한 쪽, 500번대는 받는 쪽 문제예요
- ·맨 윗줄 한 줄에 답이 있어요
- ·요약하지 말고 그대로 복사해서 보여주세요
- ·직전에 고친 것이 원인인 경우가 가장 많아요