Labstack Echo自定义HTTPErrorHandler返回状态码恒为200问题求解

• 错误1：你调用context.SetResponse(&echo.Response{Status: http.StatusBadRequest})是错误用法，该方法会直接替换上下文绑定的响应实例，新实例未关联底层的http.ResponseWriter，你设置的状态码完全不会写入实际响应
• 错误2：自定义HTTPErrorHandler没有主动向响应写入状态码和返回内容，也没有调用Echo默认的错误处理逻辑，Echo会默认返回状态码为200的空响应

方案1：修正自定义HTTPErrorHandler写法 #

正确的写法是直接通过上下文方法设置状态、写入响应，非自定义错误可以转给Echo默认错误处理器处理，代码示例：

package main

import (
    "github.com/labstack/echo/v4"
    "net/http"
)

type MyError struct{}

func (m *MyError) Error() string {
    return "boom"
}

func main() {
    e := echo.New()
    // 保存默认错误处理器，非自定义错误可以转交处理
    defaultErrorHandler := e.HTTPErrorHandler

    e.HTTPErrorHandler = func(err error, c echo.Context) {
        if myErr, ok := err.(*MyError); ok {
            println("Got MyError")
            // 直接设置状态码并返回响应即可，不需要替换Response实例
            c.String(http.StatusBadRequest, myErr.Error())
            return
        }
        // 其他错误走默认处理逻辑
        defaultErrorHandler(err, c)
    }

    e.GET("/1", func(c echo.Context) error {
        return &MyError{}
    })

    e.GET("/2", func(c echo.Context) error {
        return echo.NewHTTPError(http.StatusForbidden, "Invalid permissions ")
    })

    e.Start(":80")
}

修改后请求/1会返回400状态码，/2会返回403状态码，符合预期。

方案2：通过中间件做错误映射 #

如果你不想重写全局错误处理器，也可以用全局中间件统一处理错误映射：

func ErrorMappingMiddleware(next echo.HandlerFunc) echo.HandlerFunc {
    return func(c echo.Context) error {
        err := next(c)
        if err == nil {
            return nil
        }
        // 匹配自定义错误，转换为对应HTTP错误
        if _, ok := err.(*MyError); ok {
            return echo.NewHTTPError(http.StatusBadRequest, err.Error())
        }
        // 其他错误原样返回，走默认错误处理
        return err
    }
}

// 注册中间件
e.Use(ErrorMappingMiddleware)

这种方式不需要修改默认的HTTPErrorHandler，也能实现自定义错误到HTTP状态码的映射。

内容的提问来源于stack exchange，提问作者user2233706