Go语言http包实战教程

本文深入浅出地讲解了Go语言标准库net/http的核心用法，涵盖HTTP服务器搭建、路由注册、请求数据解析（如查询参数、表单值、请求头和方法判断）、静态文件服务、JSON响应生成及HTTP状态码设置等关键实践，通过简洁可运行的示例代码，帮助开发者快速掌握构建健壮、高效Web服务的基础能力——无需第三方依赖，一行HandleFunc即可起步，却足以支撑绝大多数真实场景。

在Golang中处理HTTP请求主要通过标准库net/http实现，它提供了简单而强大的接口来创建HTTP服务器和客户端。下面介绍如何使用它来处理常见的HTTP服务端请求。

设置基本的HTTP服务器

使用http.HandleFunc可以注册一个URL路径对应的处理函数，然后通过http.ListenAndServe启动服务器。

示例代码：

package main
import (
    "fmt"
    "net/http"
)

func helloHandler(w http.ResponseWriter, r *http.Request) {
    fmt.Fprintln(w, "Hello, World!")
}

func main() {
    http.HandleFunc("/hello", helloHandler)
    fmt.Println("Server starting on :8080...")
    http.ListenAndServe(":8080", nil)
}

访问 http://localhost:8080/hello 将返回 "Hello, World!"。

读取请求数据

处理HTTP请求时，常需要获取查询参数、请求头、表单数据等信息。这些都可以从*http.Request对象中提取。

常见操作包括：

• r.URL.Query()：获取URL查询参数
• r.Header.Get("Content-Type")：读取请求头字段
• r.Method：判断请求方法（GET、POST等）
• r.FormValue("name")：获取表单字段值（自动解析POST和URL编码）

示例：

func userInfoHandler(w http.ResponseWriter, r *http.Request) {
    if r.Method != "POST" {
        http.Error(w, "Method not allowed", http.StatusMethodNotAllowed)
        return
    }

    name := r.FormValue("name")
    age := r.FormValue("age")
    fmt.Fprintf(w, "Name: %s, Age: %s", name, age)
}

处理不同路由和静态文件

对于更复杂的路由需求，可以使用http.ServeMux进行路径分发，也可以直接用http.FileServer提供静态资源。

例如提供./static/目录下的文件：

fs := http.FileServer(http.Dir("./static/"))
http.Handle("/static/", http.StripPrefix("/static/", fs))

自定义响应与状态码

通过ResponseWriter可控制输出内容和状态码。

例如返回JSON数据：

func jsonHandler(w http.ResponseWriter, r *http.Request) {
    w.Header().Set("Content-Type", "application/json")
    w.WriteHeader(http.StatusOK)
    data := `{"message": "success"}`
    w.Write([]byte(data))
}

注意先调用Header().Set和WriteHeader，再写入响应体。

基本上就这些。net/http足够应对大多数基础Web服务场景，结构清晰且无需依赖外部库。不复杂但容易忽略细节，比如表单解析前是否调用了r.ParseForm()（通常FormValue会自动处理），或响应头设置时机。

本篇关于《Go语言http包实战教程》的介绍就到此结束啦，但是学无止境，想要了解学习更多关于Golang的相关知识，请关注golang学习网公众号！