error-handling

jhlee0409 的头像作者 jhlee0409

实现一致的错误处理和日志记录模式。在API错误响应、异常处理、错误边界和编写用户友好消息时使用。包含服务器和客户端的错误处理策略。

📖 中文导读:实现一致的错误处理和日志记录模式。在API错误响应、异常处理、错误边界和编写用户友好消息时使用。包含服务器和客户端的错误处理策略。 以下正文为该技能的原始 SKILL.md 内容(英文),上方安装命令可直接使用。

name: error-handling description: 일관된 에러 처리와 로깅 패턴을 구현합니다. API 에러 응답, 예외 처리, 에러 바운더리, 사용자 친화적 메시지 작성 시 사용하세요. 서버와 클라이언트 양쪽의 에러 처리 전략을 포함합니다. allowed-tools: Read, Glob, Grep

Error Handling Skill

Instructions

  1. Use consistent HTTP status codes
  2. Return Korean error messages to users
  3. Log detailed errors server-side only
  4. 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.