[서비스 기획 숙련] 에러 케이스 정의

포스팅 목표 : 에러 케이스와 에러 케이스 작성법

• 에러 케이스에 대해 이해하기
• 에러 케이스 작성법 살펴보기

---

1. 에러케이스

에러케이스가 뭘까요?

: 서비스나 시스템에서 발생할 수 있는 예외 상황을 정의하고 이를 어떻게 처리할지를 명확하게 기술하는 문서

 

1.2 에러케이스를 작성하는 이유는

- 유저 입장 : 서비스의 안정성과 사용자 경험을 향상시키기 위해
- 서비스 기획자 or 개발자 : 시스템이나 서비스에서 문제가 발생했을 때 어떻게 처리할지 명확히 하기 위해

1.3 서비스 오류 : 서비스가 제공하는 기능이 제대로 동작하지 않은 것

• 서비스 오류는 사용자가 서비스의 기능을 이용할 때 발생하는 오류
  (사용자가 요청한 작업이나 서비스가 정상적으로 처리되지 않았을 때 발생)
• 주로 서비스가 제공하는 기능(로그인, 결제, 검색 등)이 제대로 동작하지 않는 경우

-사용자가 비밀번호를 잘못 입력한 경우,
-결제 진행 중 카드 정보 입력란을 비워두었을 때
=> 사용자가 서비스 기능을 이용할때 사용자의 실수로 발생되는 오류

 

1.4 시스템 오류

• 시스템 오류는 서비스 내부에서 발생하는 예외적인 문제
• 서버 장애, 데이터베이스 연결 실패, API 응답 오류 등으로 개발딴에서 생긴 문제로 인해 시스템이 정상적으로 작동하지 않는 상황 (사용자에게는 “서비스를 이용할 수 없습니다"와 같은 메시지를 보여줌

=> 예전에 카카오 오류 나서 아무것도 안되었을때가 시스템 오류의 대표적인 예시

 

API 서버가 응답을 멈춘 경우

이런식으로 어떤 영역에 어떤 메세지를 띄운다를 정의한다는 실무 문서

---

 

2. 에러 케이스 작성하는 방법

-에러 케이스 정의

사용자에게 제공하는 기능마다 예상 가능한 오류 상황을 미리 예측하고 정의해야 합니다.

✅ 로그인 시 오류: 아이디/비밀번호 불일치, 계정 잠금, 세션 만료

 

-에러 발생 조건 명시

각 에러가 발생하는 조건을 명확히 정의합니다.

이를 통해 협업하는 팀이 동일한 조건을 이해하고 테스트하며, 에러 발생시 대처할 수 있습니다.

✅ 결제 시 카드 정보 오류 : 유효하지 않은 카드 번호 또는 만료된 카드로 결제를 시도할 때

 

-에러 메시지 작성

각 에러에 대해 사용자에게 보여줄 오류 메시지를 작성합니다.

에러가 발생했을 때, 사용자가 취할 수 있는 행동을 구체적으로 안내해야 합니다.

✅ 로그인 시 비밀번호 불일치시 :
❌ 로그인이 불가능합니다 
⭕ 비밀번호가 올바르지 않습니다. 다시 입력해 주세요.

에러 케이스	에러 발생 조건	에러 메시지	에러 코드
결제 시 결제 서버 오류	결제 서버와의 연결 실패 또는 응답 지연으로 결제가 처리되지 않을 때	"결제 서버에 문제가 발생했습니다. 잠시 후 다시 시도해 주세요."	PAY500
파일 업로드 실패	파일 크기가 업로드 제한을 초과하거나 파일 형식이 지원되지 않을 때	"업로드 가능한 최대 파일 크기를 초과하거나 지원되지 않는 파일 형식입니다. 파일을 확인 후 다시 시도해 주세요."	UPLOAD400
결제 시 카드 정보 오류	사용자가 입력한 카드 정보가 유효하지 않거나, 만료된 카드로 결제를 시도할 때	"입력하신 카드 정보에 오류가 있습니다. 카드 번호와 만료일을 다시 확인해 주세요."	PAY102

 

*에러 코드 쓰는 이유 :

시스템이나 개발팀이 문제를 더 빠르게 파악할 수 있도록 작성하기도 함.

필수적으로 적진 않으나 대부분 적고있는 건.