Golang实战中如何处理和响应不同的HTTP状态码-Golang-PHP中文网

Golang实战中如何处理和响应不同的HTTP状态码

P粉602998670

发布： 2025-09-11 12:43:01

原创

1064人浏览过

正确使用HTTP状态码需服务端按业务逻辑返回对应码，如创建资源用201、错误用400/404/500，并通过中间件统一处理；客户端需显式判断状态码，区分200、404等响应，避免误解析。

golang实战中如何处理和响应不同的http状态码

在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

登录后复制

，只有网络层错误才会。

AI Room Planner

AI 室内设计工具，免费为您的房间提供上百种设计方案

136

查看详情

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)
}

登录后复制

基本上就这些。关键是根据语义选对状态码，服务端清晰表达结果，客户端准确判断响应。不复杂但容易忽略细节。

以上就是Golang实战中如何处理和响应不同的HTTP状态码的详细内容，更多请关注php中文网其它相关文章！