17370845950

用 net/http 启动最简 HTTP 服务器只需三行代码：导入 net/http，调用 http.HandleFunc 注册路由，再执行 http.ListenAndServe 监听端口；默认处理器返回 404，需显式注册路径；支持函数式注册与自定义 Handler 接口实现，后者更利于测试、依赖注入和中间件扩展。

用 net/http 启动最简 HTTP 服务器

Go 自带的 net/http 包不需要额外依赖，三行代码就能跑起来。核心是调用 http.ListenAndServe，它会阻塞当前 goroutine，监听指定地址并处理请求。

常见错误是端口被占用或权限不足（如监听 :80 在非 root 用户下失败），建议开发时优先用 :8080 或更高端口。

package main

import "net/http"

func main() {
    http.ListenAndServe(":8080", nil)
}

此时服务器能启动，但所有请求都返回 404 —— 因为没注册任何路由处理器。

注册路由：用 http.HandleFunc 处理路径

http.HandleFunc 是最常用的注册方式，它把路径字符串和处理函数绑定到默认的 http.DefaultServeMux 上。注意路径匹配是前缀匹配，"/api" 会同时匹配 /api 和 /api/users。

• 路径末尾加 /（如 "/hello/"）会让 mux 自动重定向带斜杠的请求，适合目录式路由
• 不加斜杠则严格匹配完整路径，更可控
• 多个 HandleFunc 注册顺序无关，mux 内部按最长前缀匹配

package main

import (
    "fmt"
    "net/http"
)

func main() {
    http.HandleFunc("/hello", func(w http.ResponseWriter, r *http.Request) {
        fmt.Fprintf(w, "Hello, %s!", r.URL.Query().Get("name"))
    })
    http.ListenAndServe(":8080", nil)
}

自定义处理器：实现 http.Handler 接口

当逻辑变复杂、需要状态或复用时，直接写函数不够用。Go 的 http.Handler 是一个接口：func ServeHTTP(http.ResponseWriter, *http.Request)。任何实现了它的类型都能当处理器。

比起 HandleFunc，自定义结构体更易测试、可注入依赖（比如数据库连接、配置）、支持中间件链式调用。

• 不要在 ServeHTTP 里 panic，否则整个服务器可能崩溃；应统一用 http.Error 返回错误响应
• 如果嵌套多个 Handler（如用 http.StripPrefix），注意路径修改后 r.URL.Path 是否已更新
• 避免在 Handler 中长时间阻塞，除非明确做了超时控制或启用了 goroutine

type Greeter struct {
    prefix string
}

func (g Greeter) ServeHTTP(w http.ResponseWriter, r *http.Request) {
    name := r.URL.Query().Get("name")
    if name == "" {
        http.Error(w, "missing 'name'", http.StatusBadRequest)
        return
    }
    fmt.Fprintf(w, "%s, %s!", g.prefix, name)
}

func main() {
    http.Handle("/greet", Greeter{prefix: "Hi"})
    http.ListenAndServe(":8080", nil)
}

处理 POST 表单与 JSON 请求

GET 请求参数从 r.URL.Query() 拿；POST 表单（application/x-www-form-urlencoded）需先调用 r.ParseForm()，再读 r.FormValue；JSON 则要手动读取 r.Body 并解码。

容易忽略的是：多次调用 r.FormValue 或 r.PostFormValue 不会重复解析，但 r.Body 只能读一次 —— 如果之前调用了 ParseForm 或 ParseMultipartForm，r.Body 已被消费，直接读会得到空内容。

• 对 JSON，推荐用 json.NewDecoder(r.Body).Decode(&v)，比 ioutil.ReadAll + json.Unmarshal 更省内存
• 表单字段名区分大小写，r.FormValue("Name") 和 r.FormValue("name") 是不同的
• 没有显式设置 Content-Type 时，ParseForm 仍会尝试解析，但可能误判编码；建议前端明确发送 Content-Type: application/x-www-form-urlencoded

实际开发中，别只靠 http.HandleFunc 硬写逻辑，早一点封装成结构体 Handler，不然加日志、鉴权、限流时会很难维护。