Go / 系统课时

从 Handler 处理一个请求

从 Handler 处理一个请求

一个可用的 HTTP 服务可以先从最小 Handler 开始:读取请求方法、路径和查询参数,再通过 ResponseWriter 返回结构化 JSON。掌握这一条请求链路后,再扩展路由、中间件和业务逻辑会更稳。

学习目标

  • 理解 http.Handler 与 http.HandlerFunc 的职责
  • 从 http.Request 读取基础请求信息
  • 正确设置响应头并返回 JSON 结果

Handler 的最小职责

Go 的 HTTP 处理核心是 ServeHTTP(http.ResponseWriter, *http.Request)。http.HandlerFunc 只是一个适配器,可以把普通函数转换成 Handler,因此小型接口通常直接注册函数,复杂服务再把状态封装进结构体。

Handler 每次只处理一个请求,但同一个 Handler 可能被多个请求并发调用,所以不要把“当前请求”的临时数据放进共享全局变量。请求级数据应来自 *http.Request 或函数内部局部变量。

写一个最小结构化响应服务

下面的程序注册 /inspect 路由,只接受 GET 请求,并把请求方法、路径和查询参数 q 返回为 JSON。

go
package main

import (
    "encoding/json"
    "log"
    "net/http"
)

type response struct {
    Method string `json:"method"`
    Path   string `json:"path"`
    Query  string `json:"query"`
}

func inspectHandler(w http.ResponseWriter, r *http.Request) {
    if r.Method != http.MethodGet {
        http.Error(w, "method not allowed", http.StatusMethodNotAllowed)
        return
    }

    payload := response{
        Method: r.Method,
        Path:   r.URL.Path,
        Query:  r.URL.Query().Get("q"),
    }

    w.Header().Set("Content-Type", "application/json; charset=utf-8")
    if err := json.NewEncoder(w).Encode(payload); err != nil {
        log.Printf("encode response: %v", err)
    }
}

func main() {
    mux := http.NewServeMux()
    mux.HandleFunc("/inspect", inspectHandler)

    addr := ":8080"
    log.SetFlags(0)
    log.Printf("listening on %s", addr)

    if err := http.ListenAndServe(addr, mux); err != nil {
        log.Fatal(err)
    }
}

预期输出

text
listening on :8080

保持服务运行,再发起一次请求:

bash
curl -s "http://127.0.0.1:8080/inspect?q=go"

预期结果

json
{"method":"GET","path":"/inspect","query":"go"}

json.Encoder 会在响应末尾追加换行,因此终端显示时可能在 JSON 后直接换到下一行;字段内容应与上面的请求一致。

从 Request 里读取什么

本例只读取三个最常用位置:r.Method 表示 HTTP 方法,r.URL.Path 表示路由路径,r.URL.Query() 解析查询字符串。它们都属于已经由 net/http 解析好的请求元数据,不需要自己拆原始 HTTP 报文。

如果后续要读取 JSON 请求体,应先限制允许的方法和请求体大小,再使用 json.Decoder 解码。不要在还没有明确接口契约时同时读取表单、JSON 和任意二进制数据,否则错误处理会很快变得混乱。

ResponseWriter 的关键边界

调用 w.Header().Set 必须发生在第一次写响应体之前;一旦开始写响应体,默认状态码就是 200,响应头也基本确定。需要返回 4xx 或 5xx 时,应先确定错误,再写状态码和正文。

ResponseWriter 只在当前 ServeHTTP 调用期间有效,不要把它保存到 goroutine 中等 Handler 返回后再使用。如果确实需要异步任务,应先把请求所需数据复制出来,让 HTTP 响应在当前调用内完成。

一个合格的最小 Handler 至少要做到:路由明确、方法不匹配时返回可预期状态、成功响应声明正确的 Content-Type,并且每个请求只操作自己的局部数据。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

从 Handler 处理一个请求

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通