텍스트 편집
2026년 5월 16일
오류 메시지 텍스트 작성 가이드 - UX 관점
앱과 웹 서비스의 오류 메시지 텍스트를 사용자 친화적으로 작성하는 방법, 최적 글자수, 좋은 오류 메시지의 4가지 요소를 설명합니다.
Q.UX 관점에서 좋은 오류 메시지 텍스트는 어떻게 작성하나요?
좋은 오류 메시지는 4가지 요소를 포함합니다: 1) 무슨 일이 일어났는지(What), 2) 왜 발생했는지(Why), 3) 어떻게 해결하는지(How), 4) 언제 다시 시도해야 하는지(When). '오류가 발생했습니다'보다 '파일 크기가 10MB를 초과합니다. 10MB 이하 파일을 업로드해 주세요.'가 훨씬 효과적입니다. 최적 길이는 30-80자입니다.
오류 메시지 텍스트UX 글쓰기에러 메시지 작성
"오류가 발생했습니다"라는 메시지를 본 사용자는 무엇을 해야 할지 모른다. 이 메시지는 개발자에게도, 사용자에게도 쓸모가 없다. 오류 메시지 UX는 앱 신뢰도에 직접 영향을 준다.
나쁜 오류 메시지 vs 좋은 오류 메시지
| 나쁜 예 | 문제점 | 좋은 예 |
|---|---|---|
| "오류가 발생했습니다" | 원인·해결책 없음 | "인터넷 연결을 확인해 주세요." |
| "유효하지 않은 입력" | 어떤 입력인지 불명확 | "이메일 형식이 올바르지 않습니다. (예: user@email.com)" |
| "Error 404" | 사용자가 이해 불가 | "페이지를 찾을 수 없습니다. [홈으로 돌아가기]" |
| "업로드 실패" | 원인 없음 | "파일 크기가 10MB를 초과합니다. (현재: 15MB)" |
오류 메시지 4요소
What - 무슨 일이 일어났나: "비밀번호가 일치하지 않습니다."
Why - 왜 발생했나: "(이전 비밀번호와 동일한 비밀번호는 사용할 수 없습니다)"
How - 어떻게 해결하나: "새 비밀번호를 입력해 주세요."
When - 언제 다시 시도 가능한가: "5분 후 다시 시도해 주세요." (타임아웃 오류)
최적 오류 메시지 길이
- 인라인 폼 오류 (필드 아래 표시): 20-50자
- 토스트 알림: 30-60자
- 모달 대화상자: 50-120자
- 전체 페이지 오류: 80-200자
길수록 사용자가 읽지 않는다. 핵심 해결 방법을 첫 문장에 배치하는 역피라미드 구조를 적용한다.
---
이 글은 AI가 공개 자료를 기반으로 작성했습니다.