首页 > Golang > Go教程

Golang创建HTTP服务器与路由处理教程

时间：2025-08-29 19:04:22 193浏览收藏

推广推荐

支持 PC / 移动端，安全直达

本文详细介绍了如何使用 Golang 的 `net/http` 包快速创建 HTTP 服务器，并实现路由处理与请求解析，是 Golang Web 开发的入门教程。文章首先讲解了如何通过 `http.ListenAndServe` 启动基础服务器，并通过 `http.HandleFunc` 注册路径处理器。接着，深入探讨了如何利用 `r.Method` 实现 REST 风格的路由控制，以及如何解析查询参数、表单数据和 JSON 请求体。最后，文章还介绍了如何设置响应头，并返回 JSON 响应数据。通过学习本文，开发者可以掌握 Golang Web 服务开发的关键技术，轻松构建稳定高效的后端接口，无需依赖复杂的第三方框架，提升开发效率，是 Golang 开发者不可错过的实践指南。

答案：使用 net/http 包可快速创建 HTTP 服务器并实现路由与请求解析。1. 通过 http.ListenAndServe 启动服务器，http.HandleFunc 注册路径处理器。2. 使用 r.URL.Path 获取访问路径，r.Method 区分请求方法，实现 REST 风格路由。3. 调用 r.ParseForm() 解析查询参数和表单数据，r.Form.Get 获取值。4. 对 JSON 请求，检查 Content-Type 头，用 json.NewDecoder(r.Body).Decode 解码。5. 响应时设置 w.Header().Set("Content-Type", "application/json")，json.NewEncoder(w).Encode 返回 JSON 数据。掌握这些基础可构建稳定 Web 服务。

如何用Golang创建HTTP服务器实现路由处理与请求解析

用 Golang 创建 HTTP 服务器并实现路由处理与请求解析并不复杂。Go 标准库中的 net/http 包已经提供了足够强大的功能，无需依赖第三方框架即可完成常见 Web 服务开发任务。

创建基础 HTTP 服务器

使用 http.ListenAndServe 可以快速启动一个 HTTP 服务器。指定监听地址和端口，再传入一个处理器即可。

package main

import (
    "fmt"
    "net/http"
)

func helloHandler(w http.ResponseWriter, r *http.Request) {
    fmt.Fprintf(w, "Hello, 你访问的是: %s\n", r.URL.Path)
}

func main() {
    http.HandleFunc("/", helloHandler)
    fmt.Println("服务器启动在 :8080")
    http.ListenAndServe(":8080", nil)
}

这段代码注册了一个根路径的处理函数，并启动服务器监听 8080 端口。访问 http://localhost:8080 会看到返回的路径信息。

实现简单的路由控制

虽然 http.HandleFunc 支持路径注册，但若需要更清晰的路由管理，可以手动判断请求路径。

func main() {
    http.HandleFunc("/users", func(w http.ResponseWriter, r *http.Request) {
        if r.Method == "GET" {
            fmt.Fprintln(w, "获取用户列表")
        } else {
            http.Error(w, "方法不支持", http.StatusMethodNotAllowed)
        }
    })

    http.HandleFunc("/users/create", func(w http.ResponseWriter, r *http.Request) {
        if r.Method == "POST" {
            fmt.Fprintln(w, "创建新用户")
        } else {
            http.Error(w, "仅支持 POST", http.StatusMethodNotAllowed)
        }
    })

    http.ListenAndServe(":8080", nil)
}

通过判断 r.Method 可区分不同 HTTP 方法，实现基本的 REST 风格路由。

解析请求数据

实际开发中常需解析查询参数、表单数据或 JSON 请求体。Go 的 http.Request 提供了相应方法。

处理查询参数和表单：

func formHandler(w http.ResponseWriter, r *http.Request) {
    // 解析表单（包括 POST 和 URL 查询参数）
    r.ParseForm()

    name := r.Form.Get("name")
    age := r.Form.Get("age")

    fmt.Fprintf(w, "姓名: %s, 年龄: %s\n", name, age)
}

处理 JSON 请求：

type User struct {
    Name string `json:"name"`
    Age  int    `json:"age"`
}

func jsonHandler(w http.ResponseWriter, r *http.Request) {
    if r.Header.Get("Content-Type") != "application/json" {
        http.Error(w, "请使用 application/json", http.StatusBadRequest)
        return
    }

    var user User
    err := json.NewDecoder(r.Body).Decode(&user)
    if err != nil {
        http.Error(w, "JSON 解析失败", http.StatusBadRequest)
        return
    }

    fmt.Fprintf(w, "收到用户: %+v\n", user)
}

记得导入 encoding/json 包。使用 json.NewDecoder 从请求体中解码 JSON 数据。

设置响应头与返回 JSON 响应

返回 JSON 数据时，应设置正确的 Content-Type 头。

func jsonResponse(w http.ResponseWriter, r *http.Request) {
    data := map[string]string{
        "message": "操作成功",
        "status":  "ok",
    }

    w.Header().Set("Content-Type", "application/json")
    json.NewEncoder(w).Encode(data)
}

w.Header().Set 用于设置响应头，json.NewEncoder(w).Encode 将结构体编码为 JSON 并写入响应。

基本上就这些。通过 net/http 包，你可以轻松搭建具备路由分发、请求解析和响应生成能力的 HTTP 服务。不复杂但容易忽略的是方法判断、Content-Type 处理和请求体读取的边界情况。掌握这些基础，就能构建稳定的后端接口。

本篇关于《Golang创建HTTP服务器与路由处理教程》的介绍就到此结束啦，但是学无止境，想要了解学习更多关于Golang的相关知识，请关注golang学习网公众号！

golang HTTP服务器 net/http 路由处理请求解析