正确使用HTTP状态码需服务端按业务逻辑返回对应码，如创建资源用201、错误用400/404/500，并通过中间件统一处理；客户端需显式判断状态码，区分200、404等响应，避免误解析。
在Go语言开发Web服务时，正确处理和响应HTTP状态码是保证API清晰、可靠的关键。状态码不仅帮助客户端理解请求结果，还能提升系统的可维护性和用户体验。下面从服务端响应生成和客户端响应处理两个角度，说明如何在实战中合理使用HTTP状态码。
服务端：根据业务逻辑返回合适的HTTP状态码
在编写HTTP处理器时，应根据请求的处理结果选择恰当的状态码，而不是一律返回200。Go的
net/http包内置了常用状态码常量，可直接使用。
例如，创建资源成功应返回
StatusCreated，资源未找到返回
StatusNotFound：
func createUser(w http.ResponseWriter, r *http.Request) {
if r.Method != "POST" {
http.Error(w, "Method not allowed", http.StatusMethodNotAllowed)
return
}
var user User
if err := json.NewDecoder(r.Body).Decode(&user); err != nil {
http.Error(w, "Invalid JSON", http.StatusBadRequest)
return
}
// 假设保存成功
if err := saveUser(user); err != nil {
http.Error(w, "Failed to save user", http.StatusInternalServerError)
return
}
w.WriteHeader(http.StatusCreated)
json.NewEncoder(w).Encode(map[string]string{"message": "User created"})
}
关键点：
立即学习“go语言免费学习笔记（深入）”；
- 使用
http.Error
快速返回错误响应，它会自动设置状态码和消息体 - 创建资源用
StatusCreated
（201），避免与OK
（200）混淆 - 验证失败用
BadRequest
（400），权限不足用Forbidden
（403），资源不存在用NotFound
（404） - 自定义错误类型可结合中间件统一处理，减少重复代码
客户端：解析响应状态码并做相应处理
使用
http.Client发起请求后，需检查响应的
StatusCode字段，不能只判断
err是否为空。因为4xx、5xx状态码不会设置
err，只有网络层错误才会。
resp, err := http.Get("https://api.example.com/user/123")
if err != nil {
log.Fatal("Request failed:", err)
}
defer resp.Body.Close()
switch resp.StatusCode {
case http.StatusOK:
var user User
json.NewDecoder(resp.Body).Decode(&user)
fmt.Printf("User: %+v\n", user)
case http.StatusNotFound:
fmt.Println("User not found")
case http.StatusUnauthorized:
fmt.Println("Authentication required")
default:
fmt.Printf("Unexpected status: %d\n", resp.StatusCode)
}
注意：
- 即使
err == nil
，仍可能收到404或500等错误状态码 - 建议对关键接口的状态码做显式判断，避免误解析错误响应体
- 可封装通用的响应处理函数，统一处理JSON解析和状态码映射
使用中间件统一处理错误响应
在实际项目中，可通过中间件捕获处理过程中的错误，并转换为标准的错误响应格式。
func errorMiddleware(next http.HandlerFunc) http.HandlerFunc {
return func(w http.ResponseWriter, r *http.Request) {
defer func() {
if err := recover(); err != nil {
log.Println("Panic:", err)
http.Error(w, "Internal Server Error", http.StatusInternalServerError)
}
}()
next(w, r)
}
}
结合自定义错误类型，可实现更精细的控制：
type AppError struct {
Message string
Code int
}
func (h *Handler) getUser(w http.ResponseWriter, r *http.Request) {
user, err := h.userService.FindByID(id)
if err != nil {
if errors.Is(err, ErrNotFound) {
http.Error(w, "User not found", http.StatusNotFound)
return
}
http.Error(w, "Server error", http.StatusInternalServerError)
return
}
json.NewEncoder(w).Encode(user)
}
基本上就这些。关键是根据语义选对状态码，服务端清晰表达结果，客户端准确判断响应。不复杂但容易忽略细节。
