| name | error-handling |
| description | 일관된 에러 처리와 로깅 패턴을 구현합니다. API 에러 응답, 예외 처리, 에러 바운더리, 사용자 친화적 메시지 작성 시 사용하세요. 서버와 클라이언트 양쪽의 에러 처리 전략을 포함합니다. |
| allowed-tools | Read, Glob, Grep |
Error Handling Skill
Instructions
- Use consistent HTTP status codes
- Return Korean error messages to users
- Log detailed errors server-side only
- Handle
ApiError class on client-side
Status Code Quick Reference
| Code |
Use Case |
Message |
| 400 |
Invalid input |
입력 정보를 확인해주세요. |
| 401 |
Auth required |
인증이 필요합니다. |
| 403 |
No permission |
권한이 없습니다. |
| 404 |
Not found |
찾을 수 없습니다. |
| 429 |
Rate limit |
요청이 너무 많습니다. |
| 500 |
Server error |
서버 오류가 발생했습니다. |
Server-Side Pattern
try {
// logic
} catch (error) {
console.error('[API] POST /api/endpoint error:', error)
return NextResponse.json({ error: '서버 오류가 발생했습니다.' }, { status: 500 })
}
For complete patterns (client error handling, toast helpers, retry logic, error messages), see reference.md.