用 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。
立即学习“go语言免费学习笔记(深入)”;
- 路径末尾加
/(如"/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,不然加日志、鉴权、限流时会很难维护。










