Go / 系统课时
启动第一个 HTTP 服务
启动第一个 HTTP 服务
本篇用标准库 net/http 完成最小服务端闭环:在本机监听端口、把 GET /healthz 注册到处理器、记录请求日志,并用 curl 验证状态码和响应体。示例不依赖第三方框架,适合作为后续路由、超时和中间件实验的起点。
学习目标
- 使用
http.Server与http.ServeMux启动本地 HTTP 服务 - 注册并理解
GET /healthz健康检查处理器 - 从监听日志、请求日志和客户端响应验证完整请求链路
建立最小请求链路
一次请求会经过监听中的 http.Server,交给 ServeMux 按方法和路径匹配处理器,再由处理器写回状态码与响应体。为了避免第一次实验意外暴露到局域网,本例只监听 127.0.0.1:8080。

若当前目录还没有 go.mod,先建立一个最小模块;已有模块时跳过这一步。
go mod init example.com/first-http
mkdir -p cmd/server预期输出
go: creating new go.mod: module example.com/first-http然后创建 cmd/server/main.go,写入下面的完整程序。
package main
import (
"errors"
"fmt"
"log"
"net/http"
"time"
)
func main() {
mux := http.NewServeMux()
mux.HandleFunc("GET /healthz", func(w http.ResponseWriter, r *http.Request) {
// 记录方法、路径和来源地址,便于确认请求确实到达当前处理器。
log.Printf("method=%s path=%s remote=%s", r.Method, r.URL.Path, r.RemoteAddr)
w.Header().Set("Content-Type", "text/plain; charset=utf-8")
w.WriteHeader(http.StatusOK)
_, _ = fmt.Fprintln(w, "ok")
})
server := &http.Server{
Addr: "127.0.0.1:8080",
Handler: mux,
ReadHeaderTimeout: 5 * time.Second,
}
log.Printf("listening on http://%s", server.Addr)
if err := server.ListenAndServe(); !errors.Is(err, http.ErrServerClosed) {
log.Fatal(err)
}
}预期结果
源码保存后可由 go run ./cmd/server 编译并启动;服务监听 127.0.0.1:8080。这段程序显式创建自己的 ServeMux,避免把路由注册到进程级默认 mux;ReadHeaderTimeout 给读取请求头设置上限,是比裸用 http.ListenAndServe 更适合作为工程基线的最小保护。
启动并观察服务端
在项目根目录运行服务。go run 会编译并立即启动 cmd/server 包,进程会持续占用当前终端,直到你停止它。
go run ./cmd/server预期输出
<TIME> listening on http://127.0.0.1:8080<TIME> 是日志前缀中的实际时间。若这里立即出现 bind: address already in use,说明 8080 端口已被其他进程占用;先停止冲突进程,或把代码中的端口改成一个空闲端口,并让后续请求使用相同端口。
发起请求并核对结果
保持服务端终端运行,再开一个终端执行请求。-sS 隐藏进度条但保留错误,-w 在响应体后打印最终状态码。
curl -sS -w 'status=%{http_code}\n' http://127.0.0.1:8080/healthz预期输出
ok
status=200与此同时,服务端终端会新增一条请求日志。
<TIME> method=GET path=/healthz remote=127.0.0.1:<PORT><PORT> 是客户端临时端口,每次请求都可能不同。客户端看到 200 与 ok,服务端同时记录 GET /healthz,说明“监听 → 路由匹配 → 处理器执行 → 响应返回”的闭环已经打通。
GET /healthz 是带方法约束的路由模式,因此错误方法不会进入这个处理器。可以用一次反向验证确认边界。
curl -sS -o /dev/null -w '%{http_code}\n' -X POST http://127.0.0.1:8080/healthz预期输出
405到这里,最小 HTTP 服务不仅“能启动”,而且已经有可重复的验收信号:启动日志证明监听成功,请求日志证明处理器被命中,客户端状态码与正文证明响应符合预期。