Go의 특성 오류 사용 지침: 실전 가이드

Key Takeaways

1. Go의 사용자 정의 오류는 일반 오류에 비해 더 나은 컨텍스트와 타입 안전성을 제공합니다.
2. 구조체 기반 사용자 정의 오류는 더 풍부한 오류 메시지와 오류 코드와 같은 구조화된 데이터를 허용합니다.
3. 특히 오류를 래핑할 때 errors.Is 및 errors.As를 사용하여 사용자 정의 오류를 안전하게 처리하고 식별합니다.

Go (Golang)는 명시적인 오류 검사를 강조하면서 간단하면서도 강력한 오류 처리 방법을 제공합니다. 내장된 error 타입은 많은 시나리오에 충분하지만, 복잡한 애플리케이션은 더 나은 명확성, 분류 및 디버깅을 위해 사용자 정의 오류가 필요한 경우가 많습니다. 이 가이드에서는 Go에서 사용자 정의 오류를 효과적으로 정의, 생성 및 사용하는 방법을 살펴봅니다.

사용자 정의 오류를 사용하는 이유?

사용자 정의 오류를 사용하면 다음과 같은 이점이 있습니다.

• 컨텍스트: 무엇이, 어디서, 왜 잘못되었는지 설명합니다.
• 타입 안전성: 코드 소비자가 특정 오류 유형을 감지하도록 합니다.
• 더 나은 디버깅: 구조화된 정보 (예: 코드, 메타데이터)를 전달합니다.

errors.New를 사용한 기본 사용자 정의 오류

사용자 정의 오류를 정의하는 가장 간단한 방법은 다음과 같습니다.

import "errors"

var ErrUnauthorized = errors.New("권한 없는 접근")

이렇게 하면 errors.Is를 사용하여 확인할 수 있는 센티넬 오류 값이 생성됩니다.

if err == ErrUnauthorized {
    // 권한 없는 경우 처리
}

그러나 이 접근 방식은 동적 컨텍스트를 첨부할 수 없다는 제한이 있습니다.

구조체 기반 사용자 정의 오류

더 많은 컨텍스트를 포함하려면 error 인터페이스를 구현하여 자체 오류 유형을 정의하십시오.

type ValidationError struct {
    Field   string
    Message string
}

func (e *ValidationError) Error() string {
    return "'" + e.Field + "' 필드에서 유효성 검사 실패: " + e.Message
}

사용법:

err := &ValidationError{
    Field:   "email",
    Message: "잘못된 형식",
}

fmt.Println(err) // 'email' 필드에서 유효성 검사 실패: 잘못된 형식

그런 다음 타입 단언을 사용할 수 있습니다.

if vErr, ok := err.(*ValidationError); ok {
    fmt.Println("Field:", vErr.Field)
}

errors.As 및 errors.Is 사용

오류를 래핑할 때 (예: fmt.Errorf 또는 errors.Join 사용), errors.As 또는 errors.Is를 사용하여 특정 오류 유형을 계속 확인할 수 있습니다.

return fmt.Errorf("처리 실패: %w", err)

나중에:

if errors.As(err, &ValidationError{}) {
    // 유효성 검사 오류 처리
}

또는:

if errors.Is(err, ErrUnauthorized) {
    // 알려진 센티넬 오류 처리
}

오류 코드가 있는 사용자 정의 오류

오류 코드 또는 카테고리를 전달하는 사용자 정의 오류 유형을 디자인할 수 있습니다.

type AppError struct {
    Code    int
    Message string
}

func (e *AppError) Error() string {
    return fmt.Sprintf("코드 %d: %s", e.Code, e.Message)
}

const (
    ErrCodeInvalidInput = 1001
    ErrCodeNotFound     = 1002
)

그런 다음:

return &AppError{
    Code:    ErrCodeInvalidInput,
    Message: "필수 필드 누락",
}

그리고 나중에:

if appErr, ok := err.(*AppError); ok && appErr.Code == ErrCodeNotFound {
    // 찾을 수 없음 처리
}

스택 추적 래핑 (선택 사항)

고급 사용 사례의 경우 pkg/errors 또는 Go 1.20의 errors.Join과 같은 라이브러리를 사용하면 전체 오류 스택 추적을 유지하고 여러 오류를 구성할 수 있습니다.

모범 사례

• 오류 의미가 정적이고 널리 재사용되는 경우 센티넬 오류 (var ErrSomething = errors.New(...))를 사용합니다.
• 컨텍스트 기반 또는 타입 오류 처리를 위해 구조체 기반 사용자 정의 오류 유형을 정의합니다.
• 추가 검사를 위해 %w를 사용하여 오류를 항상 래핑하고 전파합니다.
• 오류에 대한 문자열 비교를 피하십시오. errors.Is 또는 errors.As를 사용하십시오.

결론

Go의 철학은 오류를 일급 값으로 취급하도록 권장합니다. 사용자 정의 오류를 만들면 더 유지 관리 가능하고 디버깅 가능하며 강력한 코드를 작성할 수 있습니다. API, 미들웨어 또는 대규모 애플리케이션을 구축하든 사용자 정의 오류는 스택 전체에서 의도와 컨텍스트를 명확하게 전달하는 데 도움이 됩니다.

FAQs

errors.New 대신 사용자 정의 오류 유형을 사용해야 하는 이유는 무엇입니까?

사용자 정의 오류 유형을 사용하면 구조화된 데이터를 전달하고 오류 처리에 대한 더 나은 제어를 제공할 수 있습니다.

래핑 후 특정 사용자 정의 오류를 확인하려면 어떻게 해야 합니까?

errors.As를 사용하여 기본 오류 유형을 안전하게 추출합니다.

errors.Is와 errors.As의 차이점은 무엇입니까?

errors.Is는 특정 오류 값에 대해 검사합니다. errors.As는 유형별로 오류를 추출합니다.

Go 프로젝트 호스팅을 위한 최고의 선택, Leapcell입니다.

Leapcell은 웹 호스팅, 비동기 작업 및 Redis를 위한 차세대 서버리스 플랫폼입니다.

다국어 지원

• Node.js, Python, Go 또는 Rust로 개발하세요.

무제한 프로젝트를 무료로 배포

• 사용량에 대해서만 비용을 지불합니다. 요청도 없고, 요금도 없습니다.

타의 추종을 불허하는 비용 효율성

• 유휴 요금 없이 사용한 만큼 지불합니다.
• 예: $25는 평균 응답 시간 60ms에서 694만 건의 요청을 지원합니다.

간소화된 개발자 경험

• 간편한 설정을 위한 직관적인 UI.
• 완전 자동화된 CI/CD 파이프라인 및 GitOps 통합.
• 실행 가능한 통찰력을 위한 실시간 메트릭 및 로깅.

간편한 확장성 및 고성능

• 고도의 동시성을 쉽게 처리할 수 있는 자동 확장.
• 운영 오버헤드가 제로입니다. 구축에만 집중하세요.

설명서에서 자세히 알아보세요!

X에서 팔로우하세요: @LeapcellHQ