创建 HTTP 服务器
ListenAndServe、HandlerFunc 与 ServeMux
创建 HTTP 服务器 是 CoddyKit 上的免费 Go Academy 课时。 这是第 1 节课，共 4 节。 你可以在下方免费阅读本课时的完整内容 — 然后在浏览器中使用内置代码编辑器和全天候 AI 导师进行实践。 这是 Go Academy 学习路径的一部分，你的进度在网页和 CoddyKit 应用中同步。 Go Academy 课程共包含 4 节课。
net/http 包
Go 的标准库 net/http 提供了无需外部依赖、可用于生产环境的 HTTP/1.1 和 HTTP/2 服务器。
基本服务器
使用 http.HandleFunc 注册处理程序，并使用 http.ListenAndServe 开始监听：
http.HandleFunc("/hello", func(w http.ResponseWriter, r *http.Request) {
fmt.Fprintln(w, "Hello, World!")
})
log.Fatal(http.ListenAndServe(":8080", nil))http.Handler 接口
任何实现了 ServeHTTP(ResponseWriter, *Request) 的类型都是 http.Handler。对于包含数据库或配置的有状态处理程序，请使用这种方式。
type App struct{ db *sql.DB }
func (a *App) ServeHTTP(w http.ResponseWriter, r *http.Request) {
// use a.db
}ServeMux
http.NewServeMux() 会创建一个隔离的路由器。请将它传递给 http.ListenAndServe，以避免使用全局默认多路复用器（在库中这样更安全）。
mux := http.NewServeMux()
mux.HandleFunc("/api/users", usersHandler)
http.ListenAndServe(":8080", mux)返回状态码
请在写入响应体之前，使用 w.WriteHeader(code) 写入状态码。如果只调用 w.Write，状态码默认是 200。
w.WriteHeader(http.StatusCreated)
w.Write([]byte("created"))编写 JSON 响应
请在写入响应体之前设置 Content-Type，然后使用 json.Encoder 进行编码：
w.Header().Set("Content-Type", "application/json")
json.NewEncoder(w).Encode(data)读取请求
通过 *Request 结构体访问方法、URL、请求头、查询参数和请求体。
r.Method // "GET", "POST", ...
r.URL.Path // "/api/users"
r.URL.Query().Get("id") // query param
r.Header.Get("Authorization")解析 JSON 请求体
使用 json.Decoder 解码请求体。请使用 http.MaxBytesReader 限制请求体大小，以防止内存耗尽。
r.Body = http.MaxBytesReader(w, r.Body, 1<<20)
var req CreateUserRequest
json.NewDecoder(r.Body).Decode(&req)服务器配置
请使用自定义的 http.Server 配置超时，以防止慢客户端攻击：
srv := &http.Server{
Addr: ":8080",
Handler: mux,
ReadTimeout: 5 * time.Second,
WriteTimeout: 10 * time.Second,
IdleTimeout: 120 * time.Second,
}
srv.ListenAndServe()HTTPS
使用 srv.ListenAndServeTLS(certFile, keyFile) 提供 HTTPS 服务。证书可以是自签名证书（开发环境），也可以来自 Let's Encrypt（通过 golang.org/x/crypto/acme/autocert 用于生产环境）。
处理程序组合
您可以包装处理程序来添加横切关注点（日志记录、身份验证、恢复），而无需修改业务逻辑。修改后请返回下一个处理程序。
快速检查
为什么应该在 http.Server 上设置 ReadTimeout 和 WriteTimeout？
回顾：创建 HTTP 服务器
关键要点：
- 使用 HandleFunc + ListenAndServe 创建简单服务器
- 在生产环境中使用带超时设置的自定义 http.Server
- 使用 ServeMux 实现隔离的路由
- 使用 json.NewEncoder(w) 返回 JSON 响应
常见问题解答
「创建 HTTP 服务器」课时是免费的吗？
是的 — 「创建 HTTP 服务器」的完整文本可在网页上免费阅读。要进行交互式练习（内置代码编辑器和全天候 AI 导师）并解锁 Go Academy 课程的其余内容，请升级到 CoddyKit PRO。 Go Academy 课程共包含 4 节课。
「创建 HTTP 服务器」这节课中我会学到什么？
ListenAndServe、HandlerFunc 与 ServeMux 你通过在浏览器中直接运行的动手代码来练习 Go Academy，全天候 AI 导师会在你学习这节课的过程中回答你的问题。
学习 Go Academy 需要有经验吗？
无需任何先前经验。CoddyKit 上的 Go Academy 课程适合初学者到高级学习者，你可以从这里开始或从头开始，按照自己的节奏学习。 这是第 1 节课，共 4 节。
「创建 HTTP 服务器」课时需要多长时间？
大多数 CoddyKit 课程大约需要 5–10 分钟。每节课都很精短且互动，所以你能稳步进步，并在网页和应用中从离开的地方继续。
我能在这节 Go Academy 课中编写并运行代码吗？
能。每节 Go Academy 课都包含内置代码编辑器，你可以在浏览器中直接编写并运行真实代码，并获得即时 AI 反馈 — 无需本地设置。