如何处理 http 错误?使用 http.error 方法:便捷方法,输入错误字符串和 http 状态码,直接写入响应。使用 responsewriter.writeheader 和 io.writestring:更灵活,可自定义状态码和错误消息。使用自定义错误类型:复杂场景下,创建自定义类型,用 errors.as 函数检查特定错误。
如何在 Go 框架中处理 HTTP 错误
在构建 Go 应用时,处理 HTTP 错误对于提供高品质的用户体验至关重要。本文将介绍如何在 Go 框架中处理 HTTP 错误,并提供一个实战案例来演示其实现。
使用 http.Error 方法
立即学习“go语言免费学习笔记(深入)”;
http.Error 方法是处理 HTTP 错误的最简单和最常用的方法。它将一个错误字符串和 HTTP 状态码作为参数,并将响应写入客户端。
import "net/http" func errorHandler(w http.ResponseWriter, r *http.Request) { // 404 Not Found http.Error(w, "Page not found", http.StatusNotFound) }
使用 ResponseWriter.WriteHeader 和 io.WriteString
一种更灵活的方法是用 ResponseWriter.WriteHeader 设置状态码,然后使用 io.WriteString 写入自定义错误消息。
import ( "io" "net/http" ) func errorHandler(w http.ResponseWriter, r *http.Request) { // 400 Bad Request w.WriteHeader(http.StatusBadRequest) io.WriteString(w, "Bad request") }
使用自定义错误类型
对于更复杂的错误处理,你可以创建自定义错误类型,并使用 errors.As 函数检查特定类型的错误。
type PageNotFoundError struct { Page string } func (e PageNotFoundError) Error() string { return fmt.Sprintf("Page %s not found", e.Page) } func errorHandler(w http.ResponseWriter, r *http.Request) { err := getPage(r.URL.Path) if err != nil { var notFoundErr PageNotFoundError // 检查是否为 PageNotFoundError 类型错误 if errors.As(err, ¬FoundErr) { http.Error(w, notFoundErr.Error(), http.StatusNotFound) } else { // 其他错误处理逻辑 } } }
实战案例
以下是一个使用 http.Error 方法和自定义错误类型的实战案例:
import ( "fmt" "html/template" "net/http" ) type PageNotFoundError struct { Page string } func (e PageNotFoundError) Error() string { return fmt.Sprintf("Page %s not found", e.Page) } func errorHandler(w http.ResponseWriter, r *http.Request) { tmpl, err := template.ParseFiles("error.html") if err != nil { http.Error(w, "Internal server error", http.StatusInternalServerError) return } var notFoundErr PageNotFoundError if errors.As(err, ¬FoundErr) { // 显示错误模板并传递错误详情 tmpl.Execute(w, map[string]interface{}{ "error": notFoundErr, }) } else { // 其他错误处理逻辑 } } func main() { http.HandleFunc("/", errorHandler) http.ListenAndServe(":8080", nil) }
在 error.html 模板中,你可以定义自定义错误页面的布局和内容。