go-errors
Use when handling errors in Go: errors.Is, errors.As, error wrapping with fmt.Errorf %w, sentinel errors, typed error trees, panic/recover boundaries. Apply to .go files that return error or import th
SKILL.mdassets/skills/go/go-errors/SKILL.md
GitHubGo Error Handling Patterns
Go 에러 처리 패턴 및 best practices.
Quick Reference
에러 처리 패턴
│
├─ 에러 래핑 ────> fmt.Errorf("context: %w", err)
│
├─ 에러 체크 ────> errors.Is() / errors.As()
│
├─ Sentinel ────> var ErrNotFound = errors.New(...)
│
└─ Custom Type ─> Error() string 구현
Error Wrapping
컨텍스트를 추가하여 에러 추적을 용이하게 합니다.
// Good - 컨텍스트 추가
if err != nil {
return fmt.Errorf("failed to get user %d: %w", userID, err)
}
// Bad - 컨텍스트 없음
if err != nil {
return err
}
Error Checking
// errors.Is: 특정 에러 값 체크
if errors.Is(err, sql.ErrNoRows) {
return nil, ErrUserNotFound
}
// errors.As: 에러 타입 체크
var validationErr *ValidationError
if errors.As(err, &validationErr) {
return nil, validationErr
}
Sentinel Errors
// internal/domain/errors.go
var (
ErrUserNotFound = errors.New("user not found")
ErrInvalidInput = errors.New("invalid input")
ErrUnauthorized = errors.New("unauthorized")
)
Custom Error Types
type ValidationError struct {
Field string
Message string
}
func (e *ValidationError) Error() string {
return fmt.Sprintf("validation error: %s - %s", e.Field, e.Message)
}
// 사용 예시
func ValidateUser(u *User) error {
if u.Email == "" {
return &ValidationError{Field: "email", Message: "required"}
}
return nil
}
Anti-patterns
| Mistake | Correct | Why |
|---|---|---|
_ = err |
if err != nil { ... } |
에러 무시 금지 |
return err |
return fmt.Errorf("context: %w", err) |
컨텍스트 추가 |
err.Error() == "..." |
errors.Is(err, target) |
문자열 비교 금지 |
err.(*MyError) |
errors.As(err, &target) |
래핑된 에러도 처리 |