Go / 系统课时

启动第一个 HTTP 服务

启动第一个 HTTP 服务

本篇用标准库 net/http 完成最小服务端闭环:在本机监听端口、把 GET /healthz 注册到处理器、记录请求日志,并用 curl 验证状态码和响应体。示例不依赖第三方框架,适合作为后续路由、超时和中间件实验的起点。

学习目标

  • 使用 http.Server 与 http.ServeMux 启动本地 HTTP 服务
  • 注册并理解 GET /healthz 健康检查处理器
  • 从监听日志、请求日志和客户端响应验证完整请求链路

建立最小请求链路

一次请求会经过监听中的 http.Server,交给 ServeMux 按方法和路径匹配处理器,再由处理器写回状态码与响应体。为了避免第一次实验意外暴露到局域网,本例只监听 127.0.0.1:8080。

HTTP 健康检查请求链路

若当前目录还没有 go.mod,先建立一个最小模块;已有模块时跳过这一步。

bash
go mod init example.com/first-http
mkdir -p cmd/server

预期输出

text
go: creating new go.mod: module example.com/first-http

然后创建 cmd/server/main.go,写入下面的完整程序。

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)
    }
}

预期结果

text
源码保存后可由 go run ./cmd/server 编译并启动;服务监听 127.0.0.1:8080。

这段程序显式创建自己的 ServeMux,避免把路由注册到进程级默认 mux;ReadHeaderTimeout 给读取请求头设置上限,是比裸用 http.ListenAndServe 更适合作为工程基线的最小保护。

启动并观察服务端

在项目根目录运行服务。go run 会编译并立即启动 cmd/server 包,进程会持续占用当前终端,直到你停止它。

bash
go run ./cmd/server

预期输出

text
<TIME> listening on http://127.0.0.1:8080

<TIME> 是日志前缀中的实际时间。若这里立即出现 bind: address already in use,说明 8080 端口已被其他进程占用;先停止冲突进程,或把代码中的端口改成一个空闲端口,并让后续请求使用相同端口。

发起请求并核对结果

保持服务端终端运行,再开一个终端执行请求。-sS 隐藏进度条但保留错误,-w 在响应体后打印最终状态码。

bash
curl -sS -w 'status=%{http_code}\n' http://127.0.0.1:8080/healthz

预期输出

text
ok
status=200

与此同时,服务端终端会新增一条请求日志。

text
<TIME> method=GET path=/healthz remote=127.0.0.1:<PORT>

<PORT> 是客户端临时端口,每次请求都可能不同。客户端看到 200 与 ok,服务端同时记录 GET /healthz,说明“监听 → 路由匹配 → 处理器执行 → 响应返回”的闭环已经打通。

GET /healthz 是带方法约束的路由模式,因此错误方法不会进入这个处理器。可以用一次反向验证确认边界。

bash
curl -sS -o /dev/null -w '%{http_code}\n' -X POST http://127.0.0.1:8080/healthz

预期输出

text
405

到这里,最小 HTTP 服务不仅“能启动”,而且已经有可重复的验收信号:启动日志证明监听成功,请求日志证明处理器被命中,客户端状态码与正文证明响应符合预期。

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

目录与阅读设置

阅读设置

17

记录一个想法

启动第一个 HTTP 服务

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

登录哪都通