Go语言chi框架中errors.As在Handler包装器内失效的问题排查

我正在使用Go语言的chi框架构建API，并创建了Handler包装器用于拦截和识别错误。相关代码如下：

func BuildHandler(db *sql.DB) *chi.Mux {
    // Repositories
    userRepository := user.NewRepository(db)

    // Api Handlers
    authHandler := auth.NewAuthAPIHandler(userRepository)

    r := chi.NewRouter()
    // r.Use(middleware.Recoverer)

    r.Method("POST", "/auth/login", handler.Handler(authHandler.Login()))

    return r
}

type Handler func(w http.ResponseWriter, r *http.Request) error

func (h Handler) ServeHTTP(w http.ResponseWriter, r *http.Request) {
    if err := h(w, r); err != nil {
        fmt.Println(reflect.TypeOf(err))

        var valErrs validator.ValidationErrors
        if errors.As(err, &valErrs) {
            fmt.Println("called here")
        }

        w.Write([]byte("error"))
    }
}

func (a *AuthAPI) Login() handler.Handler {
    return func(w http.ResponseWriter, r *http.Request) error {
        var loginDTO LoginDTO

        err := json.NewDecoder(r.Body).Decode(&loginDTO)
        if err != nil {
            return err
        }

        email, err := a.service.Login(r.Context(), loginDTO)
        if err != nil {
            fmt.Println(reflect.TypeOf(err))
            return err
        }

        w.Write([]byte(email))
        return nil
    }
}

在Login处理器和ServeHTTP方法中，通过reflect.TypeOf(err)都返回validator.ValidationErrors类型，但errors.As仅在Login处理器中生效，在ServeHTTP中无法匹配。请问这是什么原因？我希望errors.As能在ServeHTTP中正常工作。

核心原因 #

validator.ValidationErrors本质是切片类型（定义为type ValidationErrors []FieldError），而errors.As的匹配规则要求：目标类型必须是指针类型，且指向的类型要实现error接口，同时与错误链中的类型兼容。

当你直接返回validator.ValidationErrors切片时，它本身实现了error接口，但errors.As传入的&valErrs是*validator.ValidationErrors（切片的指针），而切片指针并不实现error接口，导致匹配失败。

Login处理器中能生效，大概率是service层返回的是*validator.ValidationErrors指针类型，而非切片本身；但错误传递到ServeHTTP时，可能被隐式转换为切片类型，导致errors.As无法识别。

解决方法 #

有两种可行的修复方式：

1. 统一返回指针类型
   修改a.service.Login的返回值，确保它返回*validator.ValidationErrors而非validator.ValidationErrors，这样在ServeHTTP中errors.As(err, &valErrs)就能正确匹配。

2. 直接使用类型断言
   如果无法修改service层的返回逻辑，可以跳过errors.As，直接用类型断言匹配：

   func (h Handler) ServeHTTP(w http.ResponseWriter, r *http.Request) {
       if err := h(w, r); err != nil {
           fmt.Println(reflect.TypeOf(err))
   
           if valErrs, ok := err.(validator.ValidationErrors); ok {
               fmt.Println("called here")
               // 在这里处理验证错误逻辑
           }
   
           w.Write([]byte("error"))
       }
   }
   

   因为validator.ValidationErrors本身实现了error接口，直接类型断言可以成功。如果错误存在多层包装，需要结合errors.Unwrap逐层解析，或确保包装的是指针类型。

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