무엇이, 어디서 잘못됐나

KRDS BP-062 — 어떤 종류의 오류가 어떤 지점에서 발생했는지 문제를 분명하게 설명하고 있다.

0. 들어가며 — “오류가 발생했습니다”만으론 못 고친다

이번 628편은 어떤 종류의 오류가 어떤 지점에서 발생했는지 문제를 분명하게 설명하라는 규칙입니다.

‘오류가 발생했습니다’ 같은 모호한 메시지로는 — 사용자가 무엇을 어떻게 고쳐야 할지 모르죠. BP-062는 오류의 종류와 지점을 분명히 설명하라고 규정합니다. BP-061(인지)이 ’오류가 났음’이면, BP-062는 ’무엇이 잘못됐는지’죠.

1. 원문 — 오류 종류·지점 명확 설명

BP-062 (기본 패턴 > 오류) “어떤 종류의 오류가 어떤 지점에서 발생했는지 문제를 분명하게 설명하고 있다.”

오류의 종류와 발생 지점을 분명하게 설명하라는 뜻입니다.

정리: 오류가 무엇이고 어디서 났는지 분명히 설명하라. 이게 BP-062입니다.

2. 왜 명확한 설명인가

오류 메시지의 목적은, 사용자가 문제를 이해하고 고치게 하는 것입니다. 그러려면 무엇이(종류), 어디서 (지점) 잘못됐는지 분명해야 하죠. 모호한 메시지는 사용자를 막막하게 합니다. BP-062는 명확한 설명을 요구합니다.

모호한 오류 메시지의 문제:

무엇이 문제인지 모름 ‘오류가 발생했습니다’, ‘입력값이 올바르지 않습니다’ 같은 모호한 메시지는, 사용자가 무엇을 어떻게 고쳐야 할지 모릅니다. 막막하죠.

어디서 났는지 모름 여러 항목을 입력한 폼에서 ’오류가 있습니다’만 나오면, 사용자는 어느 항목이 문제인지 일일이 찾아야 합니다.

반복 실패 — 무엇이·어디가 문제인지 모르면 — 고쳐도 또 틀리고, 결국 포기하죠.

그래서 BP-062는 — 종류와 지점을 분명히 설명하라고 합니다:

오류 종류 무엇이 잘못됐는지 구체적으로요. 예: ‘필수 항목입니다’(누락), ‘이메일 형식이 올바르지 않습니다’ (형식), ‘비밀번호는 8자 이상이어야 합니다’(규칙 위반). 모호한 ’오류’가 아니라 정확한 문제를 짚죠.

발생 지점 어느 항목·위치에서 났는지요. 해당 입력 필드를 시각적으로 표시(빨간 테두리)하고, 메시지를 그 필드 옆에 둡니다(BP-061의 위치). 여러 오류면 각 항목별로 표시하고, 상단에 ‘○건의 오류’ 요약 + 각 항목 링크를 주죠.

구체적·실행 가능 — 설명은 — 구체적이고, 사용자가 행동할 수 있게요. ‘잘못됨’이 아니라’○○를 ○○하세요’에 가깝게(다음 편 BP-063의 해결 방법과 연결).

좋은 오류 메시지의 3요소(BP-062~064).

무엇이/어디서(BP-062) — 문제를 명확히.

어떻게 고치나(BP-063) — 해결 방법을.

정중하게(BP-064) — 사용자 탓하지 않는 문체로.

BP-062는 — 그중 ’문제 식별’을 담당하죠.

WCAG 연계. 오류 식별(WCAG 3.3.1 Error Identification) — 오류가 난 항목을 식별하고 텍스트로 설명하라는 기준의 적용입니다. 자동 감지되는 오류는 — 어느 항목인지 알리고 텍스트로 설명해야 하죠.

이 규칙은 오류의 ’문제 식별’을 담당합니다 — 오류 종류·지점을 분명히 설명해(062), 사용자가 무엇이 어디서 잘못됐는지 이해하게 하죠.

정리하면 — 모호한 오류 메시지로는 사용자가 무엇을 어디서 고칠지 모르므로, 오류의 종류(무엇이 잘못)와 지점(어느 항목) 을 구체적이고 분명하게 설명해야 합니다.

3. 점검 / 개선

무엇을 점검하나

종류 명확 — 무엇이 잘못됐는지 구체적으로 설명하는가(‘필수’, ‘형식 오류’ 등).

지점 명확 — 어느 항목·위치에서 났는지 표시하는가(필드 강조, 옆 메시지).

요약·링크 — 여러 오류 시 상단 요약 + 각 항목 링크가 있는가.

개선 방향

‘오류 발생’ 대신 구체적 종류(‘이메일 형식이 올바르지 않습니다’).

오류 항목 강조 + 옆 메시지. 다건은 상단 요약·링크(WCAG 3.3.1).

4. 누가 담당하나 / 우리 사이트에 해당될까?

역할	책임
기획/UX 라이터	오류 메시지 문구 설계
개발	오류 종류·지점 표시 구현

기관 유형	BP-062 적용
중앙행정기관(대표·운영) / 공공기관 / 지자체	✅ 필수 (폼·작업 오류)

폼·작업이 있는 모든 사이트가 해당됩니다.

5. 30초 자가진단 + FAQ

✅ 30초 자가진단

□ 무엇이 잘못됐는지 구체적으로 설명하나요(‘필수’, ‘형식’ 등)?

□ 어느 항목·위치에서 났는지 표시하나요(필드 강조, 옆 메시지)?

□ 여러 오류 시 상단 요약 + 각 항목 링크가 있나요?

❓ FAQ

Q1. ‘오류가 발생했습니다’면 안 되나요?** 너무 모호합니다. 무엇이 어디서 잘못됐는지 모르죠. ’이메일 형식이 올바르지 않습니다’처럼 구체적이어야 사용자가 고칩니다. Q2. 여러 항목이 틀렸으면요? 각 항목을 개별 표시하고, 폼 상단에’○건의 오류’ 요약 + 각 항목으로 가는 링크를 줍 니다. 사용자가 하나씩 찾아 고치게요. Q3. BP-061(인지)과 뭐가 다른가요?** BP-061은 ‘오류가 났음’을 눈에 띄게(시각), BP-062는 ’무엇이 어디서 잘못됐는지’ 를 설명(내용)입니다. 함께 좋은 오류 안내를 이루죠.

6. 마무리

BP-062의 메시지:

무엇이, 어디서 잘못됐나 — 오류의 종류와 지점을 분명하게 설명하라.

모호한 메시지로는 사용자가 무엇을 어디서 고칠지 모릅니다. 오류 종류·지점을 구체적으로 설명해 문제를 이해하게 하는 게 핵심이죠. 다음 편은 오류 해결 방법 제공입니다.

다음 편 예고 ▶ 「629. (BP-063) 오류 안내와 함께 오류를 수정할 수 있는 방법을 제공하고 있다.」

ViewCheck는 오류의 종류와 지점이 분명하게 설명되는지를 진단합니다.

📚 참고 출처

KRDS 기본 패턴 — 오류 가이드 — https://www.krds.go.kr/html/site/pattern/pattern_07.html

WCAG 2.1 SC 3.3.1 Error Identification — https://www.w3.org/WAI/WCAG21/Understanding/error-identification.html

KRDS #ViewCheck #공공웹사이트 #전자정부 #디지털정부 #웹접근성 #디자인시스템 #UIUX #UI컴포넌트 #웹표준

KRDS,ViewCheck,공공웹사이트,전자정부,디지털정부,웹접근성,디자인시스템,UIUX,UI컴포넌트,웹표준