go-error-checking

JamesPrial 的头像作者 JamesPrial

使用 errors.Is 和 errors.As 进行类型安全的错误检查

📖 中文导读:使用 errors.Is 和 errors.As 进行类型安全的错误检查 以下正文为该技能的原始 SKILL.md 内容(英文),上方安装命令可直接使用。

name: go-error-checking description: Type-safe error inspection using errors.Is and errors.As

Error Checking

Pattern

Use errors.Is to check sentinel errors and errors.As to extract error types.

errors.Is - Check Sentinel Errors

// CORRECT
if errors.Is(err, user.ErrNotFound) {
    return http.StatusNotFound
}

// WRONG - breaks with wrapped errors
if err == user.ErrNotFound { }

errors.As - Extract Error Types

// CORRECT - extracts specific error type
var pathErr *fs.PathError
if errors.As(err, &pathErr) {
    log.Printf("failed path: %s", pathErr.Path)
    log.Printf("operation: %s", pathErr.Op)
}

// WRONG - only checks direct type
if pathErr, ok := err.(*fs.PathError); ok { }

Complete Example

func HandleError(err error) {
    // Check sentinel errors
    if errors.Is(err, user.ErrNotFound) {
        fmt.Println("User not found")
        return
    }

    // Extract custom error types
    var validationErr *ValidationError
    if errors.As(err, &validationErr) {
        fmt.Printf("Validation failed: %v\n", validationErr.Fields)
        return
    }

    // Extract standard library errors
    var pathErr *fs.PathError
    if errors.As(err, &pathErr) {
        fmt.Printf("File operation failed: %s\n", pathErr.Path)
        return
    }

    // Generic error
    fmt.Printf("Unknown error: %v\n", err)
}

Key Differences

  • errors.Is: Checks if error matches a sentinel value (works through wrapping)
  • errors.As: Extracts error of specific type (works through wrapping)
  • Never use == or type assertions for wrapped errors