刚好之前研究过类似的需求，在Gin里实现这种「业务Handler只返回自定义错误，由统一逻辑处理响应」的模式，思路和你提到的标准库方案一致，只是需要适配Gin的Context机制。下面给你一步步拆解实现：

1. 定义自定义错误类型 #

先复刻标准库里的appError，同时让它实现Go的error接口，方便日志记录等场景：

import (
    "log"
    "net/http"
    "fmt"
    "github.com/gin-gonic/gin"
)

type AppError struct {
    Err     error  // 原始错误，用于后端排查
    Message string // 对外展示的友好提示
    Code    int    // HTTP状态码
}

// 实现error接口，让AppError可以作为普通error使用
func (e *AppError) Error() string {
    return e.Err.Error()
}

2. 定义自定义Handler类型 #

和标准库的appHandler类似，我们定义一个返回*AppError的Handler类型，让业务逻辑专注于业务，不用关心响应输出：

type AppHandler func(c *gin.Context) *AppError

3. 实现错误包装器（核心统一处理逻辑） #

写一个转换函数，把AppHandler转换成Gin原生的gin.HandlerFunc，这个函数就相当于标准库中自定义的ServeHTTP，负责捕获业务Handler返回的错误并统一处理响应：

func WrapHandler(fn AppHandler) gin.HandlerFunc {
    return func(c *gin.Context) {
        // 执行业务Handler，获取可能的错误
        if err := fn(c); err != nil {
            // 记录原始错误，用于后端排查
            log.Printf("Request processing error: %v", err.Err)
            
            // 统一返回JSON格式的错误响应（也可以根据需求改成HTML、XML等）
            c.JSON(err.Code, gin.H{
                "error": err.Message,
            })
            
            // 终止后续中间件/Handler的执行，避免不必要的逻辑运行
            c.Abort()
        }
    }
}

4. 编写业务Handler #

现在业务Handler只需要专注于业务逻辑，出错时返回*AppError即可，不用在每个Handler里写响应代码：

// 模拟业务结构体
type Record struct {
    ID   string
    Name string
}

// 模拟数据库查询
func getRecordByID(id string) (*Record, error) {
    if id == "0" {
        return nil, fmt.Errorf("record does not exist in database")
    }
    return &Record{ID: id, Name: "Sample User Record"}, nil
}

// 模拟模板渲染（实际项目中可以是c.HTML调用）
func renderRecord(c *gin.Context, record *Record) error {
    // 这里可以添加实际的模板渲染逻辑
    return nil
}

// 业务Handler：查询并展示记录
func ViewRecord(c *gin.Context) *AppError {
    recordID := c.Query("id")
    
    // 查询数据，出错则返回自定义错误
    record, err := getRecordByID(recordID)
    if err != nil {
        return &AppError{
            Err:     err,
            Message: "Record not found",
            Code:    http.StatusNotFound,
        }
    }
    
    // 渲染内容，出错则返回自定义错误
    if err := renderRecord(c, record); err != nil {
        return &AppError{
            Err:     err,
            Message: "Failed to display record",
            Code:    http.StatusInternalServerError,
        }
    }
    
    // 业务逻辑正常，返回正常响应
    c.JSON(http.StatusOK, record)
    return nil
}

5. 注册路由 #

最后在启动Gin时，用WrapHandler包装业务Handler后注册到路由：

func main() {
    r := gin.Default()
    
    // 用WrapHandler包装后注册路由
    r.GET("/record", WrapHandler(ViewRecord))
    
    r.Run(":8080")
}

这样实现后，所有业务Handler的错误都会被统一捕获处理，和你提到的标准库方案效果一致——业务代码不用关心错误响应的细节，全部交给统一的包装器处理，代码更简洁也更易维护。

内容的提问来源于stack exchange，提问作者Dr.eel