go - 堆栈跟踪和 golang 错误。Unwrap()

Question

我想构建一个堆栈跟踪，其中包括一个低级数据库错误和第二个人类可读的错误。

golang 1.13 中新的 errors.Unwrap() 函数是为此目的而构建的吗？不确定我明白如何使用它。寻找有关如何执行此操作的示例。

// model/book.go
package model

type Book struct {
    Id     uint32  `json:"id"     db:"id"`
    Title  string  `json:"title"  db:"title"`
    Author string  `json:"author" db:"author"`
    Price  float32 `json:"price"  db:"price"`
}

func (b *Book) Tablename() string {
    return "books"
}


// main.go
package main

func main() {
    bk := model.Book{
        Title:  "oliver twist",
        Author: "charles dickens",
        Price:  10.99,
    }

    err:= Create(&bk)
    if err !=nil {
        // how to use Unwrap?
    }

}
func Create(book *model.Book) error {
    insertSQL := "INSERT INTO ...."
    // code to insert
    if err != nil {
        return err
    }
    book.Id = uint32(lastID)
    return nil
}

Answer 1

errors.Unwrap 用于剥离已包装的错误层。

// error 1 wrapped by 2 wrapped by 3
err1 := errors.New("error 1")
err2 := fmt.Errorf("error 2: %w", err1)
err3 := fmt.Errorf("error 3: %w", err2)

fmt.Println(err1) // "error 1"
fmt.Println(err2) // "error 2: error 1"
fmt.Println(err3) // "error 3: error 2: error 1"

// unwrap peels a layer off
fmt.Println(errors.Unwrap(err3)) // "error 2: error 1"
fmt.Println(errors.Unwrap(errors.Unwrap(err3))) // "error 1"

您可以递归地展开以找到最内部的错误:

currentErr := err3
for errors.Unwrap(currentErr) != nil {
  currentErr = errors.Unwrap(currentErr)
}

fmt.Println(currentErr) // "error 1"

对于同时包含低级错误和人类可读错误的错误，您可以实现自定义错误。

type Error struct {
  LowLevel error
  HumanReadable string
}

func (e Error) Error() string {
  return e.HumanReadable
}

func (e Error) Unwrap() error {
  return e.LowLevel
}

// helper
func NewError(inner error, outer string) *Error {
  return &Error{
    LowLevel: inner, 
    HumanReadable: outer,
  }
}

在您调用的函数中:

func Create(book *model.Book) error {
  ...

  if err != nil {
     return NewError(err, "failed to create book")
  }

  ...
}

在你的来电者中:

func main() {
  ...
  err := Create(&bk)
  if err != nil {
    log.Print(errors.Unwrap(err)) // internally log low-level error
    fmt.Print(err) // present human-readable error to user
  }
  ...
}