Web Guide오류 메시지에러 문구마이크로카피
오류 메시지 문구 쓰는 법
'입력값이 올바르지 않습니다'는 아무것도 알려주지 않습니다.
무엇이 왜 잘못됐고 어떻게 고치면 되는지를 알려줘야 합니다.
01무엇을 담는가
좋은 오류 메시지는 무엇이 문제인지, 왜 그런지, 어떻게 하면 되는지를 알려줍니다. 셋 다 들어가면 길어지므로 상황에 맞게 압축합니다.
가장 중요한 것은 '어떻게 하면 되는지'입니다. 문제만 알려주고 해결책이 없으면 방문자는 막힙니다.
나쁜 메시지
'오류가 발생했습니다' · '입력값이 올바르지 않습니다' · '잘못된 요청입니다' — 무엇을 어떻게 해야 할지 알 수 없습니다
좋은 메시지
'이메일 형식을 확인해 주세요. 예: name@company.com' — 무엇이 문제이고 어떻게 고치면 되는지 명확합니다
02상황별 예시
자주 나오는 오류마다 적절한 문구가 있습니다. 개발자가 임의로 쓰지 않도록 미리 정해서 전달하세요.
화면설계서에 오류 문구를 적어 두면 개발 후 수정하는 일이 없어집니다.
필수 항목 누락
'이름을 입력해 주세요' — 어느 항목인지 명시합니다.
형식 오류
'이메일 형식을 확인해 주세요. 예: name@company.com'
길이 제한
'비밀번호는 8자 이상이어야 합니다' — 기준을 알려줍니다.
중복
'이미 등록된 이메일입니다. 등록 내역을 확인하시겠어요?' + 링크
파일 용량
'파일은 10MB 이하만 첨부할 수 있습니다. 현재 15MB입니다.'
서버 오류
'일시적인 오류입니다. 잠시 후 다시 시도해 주세요. 계속되면 ○○로 연락 주세요.'
03탓하지 않는다
'잘못 입력하셨습니다', '오류를 범했습니다' 같은 표현은 방문자를 탓하는 느낌을 줍니다. 대부분은 시스템이 요구 조건을 미리 알려주지 않아 생긴 문제입니다.
중립적이고 도와주는 어조로 쓰세요.
01
'~하셨습니다' 피하기
'잘못 입력하셨습니다' → '형식을 확인해 주세요'.
02
느낌표 자제
'오류!' 같은 표현은 불안감을 줍니다.
03
기술 용어 제거
'400 Bad Request' 같은 것을 그대로 보여주지 않습니다.
04
짧게
한 문장, 길어도 두 문장.
05
다음 행동 제시
무엇을 하면 되는지 알려줍니다.
04미리 알려주면 오류가 안 난다
가장 좋은 오류 메시지는 오류가 나지 않게 하는 것입니다. 입력 전에 조건을 알려주면 애초에 틀리지 않습니다.
비밀번호 규칙, 파일 용량 제한, 입력 형식을 칸 아래에 미리 적어 두세요.
조건 사전 안내입력칸 아래에 '8자 이상, 영문과 숫자 포함'처럼 적습니다.
입력 형식 제한숫자만 받는 칸에는 숫자만 입력되게 합니다.
실시간 충족 표시조건을 만족하면 체크 표시가 뜨게 합니다.
글자 수 카운터제한이 있는 칸에 남은 글자 수를 표시합니다.
선택지로 대체자유 입력 대신 선택지를 주면 형식 오류가 사라집니다.
CHECK POINT
□ 오류 메시지에 무엇이 문제인지 명시되어 있는가
□ 어떻게 고치면 되는지 알려주는가
□ 예시를 함께 보여주는가
□ 방문자를 탓하는 표현이 없는가
□ 기술 용어가 그대로 노출되지 않는가
□ 입력 조건을 미리 안내하고 있는가
□ 화면설계서에 오류 문구가 적혀 있는가
#오류 메시지#에러 문구#마이크로카피#폼 디자인#사용성#입력 검증#접근성#홈페이지 디자인#웹비스타#홈페이지 제작