最佳实践：使用明确定义的错误类型（errors 包）创建自定义错误提供更多详细信息适当记录错误正确传播错误，避免隐藏或抑制根据需要包装错误以添加上下文
Go 框架中的错误处理最佳实践
在 Go 应用程序中处理错误对于编写稳定、健壮的代码至关重要。Go 标准库提供了对错误处理的内置支持，但不同的框架可以有自己的最佳实践。本文介绍在使用 Go 框架时实现最佳错误处理的一些准则。
1. 使用错误类型
建议使用明确定义的错误类型，这可以简化错误处理并提高可读性。错误类型可以通过 errors 包中的 New 或者 Errorf 函数创建。
例如：
import "errors"
var ErrNotFound = errors.New("not found")
2. 使用自定义错误
在框架中编写自己的错误类型可以提供比内置错误类型更详细的信息。这允许应用程序以更有意义的方式处理错误。
例如：
type MyError struct {
Message string
}
func (e MyError) Error() string {
return e.Message
}
3. 适当的日志记录
错误处理中一个重要的方面是日志记录。框架应该提供日志记录功能，以记录所有发生的错误。这有助于调试问题和跟踪应用程序行为。
例如，使用 log 包：
import "log"
func main() {
log.Fatal(ErrNotFound)
}
4. 错误传播
函数应该正确传播错误，允许上层函数处理它们。避免隐藏或抑制错误，因为它会使调试变得困难。
func GetResource() (*Resource, error) {
db, err := connectToDB()
if err != nil {
return nil, err
}
resource, err := db.GetResource()
if err != nil {
return nil, err
}
return resource, nil
}
5. 错误包装
有时，需要增加对现有错误的上下文信息。错误包装（也称为错误累积）允许在原始错误之上添加额外的错误层。
import "fmt"
func GetResource() (*Resource, error) {
resource, err := db.GetResource()
if err != nil {
return nil, fmt.Errorf("failed to get resource: %w", err)
}
return resource, nil
}
实战案例
考虑一个使用 Gin 框架构建的 REST API，该框架处理来自数据库的错误：
import (
"errors"
"<a style='color:#f60; text-decoration:underline;' href="https://www.codesou.cn/" target="_blank">git</a>hub.com/gin-gonic/gin"
)
var ErrNotFound = errors.New("not found")
func GetResource(c *gin.Context) {
db, err := connectToDB()
if err != nil {
c.JSON(http.StatusInternalServerError, gin.H{"error": err.Error()})
return
}
resource, err := db.GetResource(c.Param("id"))
if err == ErrNotFound {
c.JSON(http.StatusNotFound, gin.H{"error": "resource not found"})
return
}
if err != nil {
c.JSON(http.StatusInternalServerError, gin.H{"error": err.Error()})
return
}
c.JSON(http.StatusOK, resource)
}
这个示例演示了：
- 使用自定义错误类型 ErrNotFound
- 正确传播错误，将其返回给 Gin 的响应处理程序
- 根据错误类型返回适当的 HTTP 状态码
