如何使用Golang搭建基础Web服务_Golang Web服务快速入门方法_技术教程

最简Web服务只需两步：注册路由（http.HandleFunc）和启动监听（http.ListenAndServe），端口格式为":8080"，该函数会阻塞goroutine；GET/POST参数需手动解析表单；返回JSON须设置Content-Type头并确保结构体字段首字母大写。

用 `net/http` 启动最简 Web 服务

Go 原生 net/http 包足够跑起一个可工作的 Web 服务，不需要任何第三方依赖。核心就两步：注册路由处理函数、调用 http.ListenAndServe。

常见错误是直接写 http.HandleFunc("/", handler) 却忘了启动监听，或者端口被占用时没处理错误返回。

http.HandleFunc 只注册路由，不启动服务；必须显式调用 http.ListenAndServe
端口如 ":8080" 开头的冒号不能省略，否则会 panic
http.ListenAndServe 第二个参数传 nil 表示使用默认的 http.DefaultServeMux
该函数会阻塞当前 goroutine，后续代码不会执行，需另起 goroutine 或放在最后

package main

import (
    "fmt"
    "net/http"
)

func main() {
    http.HandleFunc("/", func(w http.ResponseWriter, r *http.Request) {
        fmt.Fprintf(w, "Hello, World!")
    })

    fmt.Println("Server starting on :8080")
    if err := http.ListenAndServe(":8080", nil); err != nil {
        fmt.Printf("ListenAndServe error: %v\n", err)
    }
}

处理 GET/POST 请求与读取参数

Go 不像某些框架自动解析表单或 query，需要手动调用 r.ParseForm() 或 r.ParseMultipartForm() 才能访问 r.FormValue。漏掉这步会导致始终读不到参数值。

GET 和 POST 的 query 参数都能通过 r.URL.Query().Get("key") 直接读，但表单数据（application/x-www-form-urlencoded）必须先解析。

r.URL.Query().Get("id") 安全读 URL 查询参数，无需提前解析
r.FormValue("name") 读 POST 表单或 query 中同名字段，但要求已调用 ParseForm
上传文件需用 r.MultipartForm，且必须先调用 ParseMultipartForm 并设置内存限制
未调用 ParseForm 就读 r.FormValue，返回空字符串，无报错，极难排查

func handler(w http.ResponseWriter, r *http.Request) {
    if r.Method == "GET" {
        id := r.URL.Query().Get("id")
        fmt.Fprintf(w, "GET id=%s", id)
        return
    }

    if r.Method == "POST" {
        if err := r.ParseForm(); err != nil {
            http.Error(w, "ParseForm error", http.StatusBadRequest)
            return
        }
        name := r.FormValue("name")
        fmt.Fprintf(w, "POST name=%s", name)
    }
}

返回 JSON 而不是纯文本

用 json.Marshal 序列化结构体后，必须手动设置 Content-Type: application/json 头，否则浏览器或客户端可能当作 HTML 或文本解析，导致解析失败。

另外，json.Marshal 遇到不可序列化的字段（如函数、未导出字段）会静默忽略，不报错；若返回空对象 {}，优先检查字段是否首字母小写。

务必调用 w.Header().Set("Content-Type", "application/json")
结构体字段名首字母必须大写，否则 json.Marshal 不会输出该字段
建议用 json.NewEncoder(w).Encode(data) 替代 json.Marshal + Write，避免中间字节切片分配
HTTP 状态码需手动设，例如 w.WriteHeader(http.StatusOK)

type Response struct {
    Message string `json:"message"`
    Code    int    `json:"code"`
}

func jsonHandler(w http.ResponseWriter, r *http.Request) {
    w.Header().Set("Content-Type", "application/json")
    w.WriteHeader(http.StatusOK)
    json.NewEncoder(w).Encode(Response{
        Message: "OK",
        Code:    200,
    })
}

为什么不用框架也能走很远

原生 net/http 在简单服务、内部工具、API 网关前置逻辑、健康检查等场景下足够稳定高效。加一层框架（如 Gin、Echo）主要解决的是路由组织、中间件链、错误统一处理、绑定校验等开发体验问题，而非性能瓶颈。

容易被忽略的是：Go 的 http.ServeMux 不支持通配符路由（如 /users/:id）和正则匹配，所有路径匹配逻辑得自己写；同时，没有内置的请求上下文传递机制，跨中间件传值要靠 r.Context() + context.WithValue，但滥用会导致 context 泄露。