Golang用net/http搭建Web服务器教程

**Golang如何用net/http构建Web服务器：新手入门指南** 想快速上手Golang Web开发？本文将指导你使用`net/http`标准库，轻松搭建基础Web服务器。从`http.ListenAndServe()`启动服务器，到`http.HandleFunc`注册路由，再到处理GET/POST请求构建REST API，本文 step-by-step 讲解。同时，还将介绍如何通过中间件实现日志记录和CORS支持，以及使用`http.NewServeMux`进行更灵活的路由管理。掌握这些核心技巧，你就能构建出结构清晰、易于扩展的Golang API服务，为你的Web开发之旅打下坚实基础。无论你是Golang新手还是希望深入理解`net/http`，本文都是你的不二之选！

构建基础Web服务器对Golang新手并不难。1. 启动服务器只需调用http.ListenAndServe()，注册路由使用http.HandleFunc并指定处理函数；2. 创建REST API需根据r.Method处理GET/POST请求，返回JSON可用json.NewEncoder；3. 中间件可通过封装处理函数实现，如日志记录或CORS支持；4. 路由管理可使用http.NewServeMux提升可控性并便于扩展。掌握这些核心点即可搭建结构清晰的API服务。

构建一个基础的Web服务器对Golang新手来说其实并不难，尤其使用标准库中的net/http包可以快速搭建出一个功能完整的API服务。关键在于理解几个核心概念并掌握基本结构。

1. 初始化HTTP服务器的基本结构

在Go中启动一个Web服务器非常简单，只需要调用http.ListenAndServe()函数即可。你可以先写一个最简单的例子：

package main

import (
    "fmt"
    "net/http"
)

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

func main() {
    http.HandleFunc("/", helloHandler)
    http.ListenAndServe(":8080", nil)
}

这段代码会启动一个监听8080端口的服务器，并在访问根路径/时返回“Hello, World!”。
其中：

• http.HandleFunc用于注册路由和对应的处理函数。
• helloHandler是处理请求的函数，接收两个参数：ResponseWriter用于写响应，*Request保存请求信息。
• ListenAndServe的第一个参数是地址（格式为host:port），第二个参数通常传nil表示使用默认的多路复用器。

2. 创建REST风格的基础API接口

接下来我们可以创建几个类似/users、/posts这样的API接口，模拟GET和POST请求。

func usersHandler(w http.ResponseWriter, r *http.Request) {
    switch r.Method {
    case "GET":
        fmt.Fprintln(w, "[{ID: 1, Name: Alice}]")
    case "POST":
        fmt.Fprintln(w, "User created")
    default:
        http.Error(w, "Method not allowed", http.StatusMethodNotAllowed)
    }
}

func main() {
    http.HandleFunc("/users", usersHandler)
    http.ListenAndServe(":8080", nil)
}

这样我们就有了一个支持GET和POST方法的/users接口。这个结构适合用来扩展更多API路径。
一些实用建议：

• 使用r.Method判断请求方法，避免错误操作。
• 返回JSON数据时，可以用json.NewEncoder(w).Encode(data)来序列化结构体。
• 可以考虑将每个handler函数单独拆分到不同文件中，方便维护。

3. 使用中间件添加日志或跨域支持

虽然net/http本身没有提供中间件机制，但可以通过封装处理函数的方式实现类似功能。例如添加一个简单的日志中间件：

func loggingMiddleware(next http.HandlerFunc) http.HandlerFunc {
    return func(w http.ResponseWriter, r *http.Request) {
        fmt.Printf("Received request: %s %s\n", r.Method, r.URL.Path)
        next(w, r)
    }
}

然后在注册路由时包装一下：

http.HandleFunc("/users", loggingMiddleware(usersHandler))

如果你需要支持CORS，可以在中间件中设置响应头：

w.Header().Set("Access-Control-Allow-Origin", "*")
w.Header().Set("Access-Control-Allow-Methods", "GET, POST, OPTIONS")

这种方式可以灵活地添加认证、限流等功能。

4. 路由组织更清晰的方式（可选）

对于稍微复杂一点的项目，直接使用http.HandleFunc可能会显得杂乱。可以考虑手动定义路由表，比如：

func main() {
    mux := http.NewServeMux()
    mux.HandleFunc("/users", loggingMiddleware(usersHandler))
    mux.HandleFunc("/posts", postsHandler)

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

这里我们创建了一个新的多路复用器mux，它比默认的更可控，也便于后续替换为第三方路由库（如Gorilla Mux）做更复杂的路由配置。

基本上就这些。用net/http构建基础API不需要太多依赖，适合新手练手或者小项目使用。只要把路由、处理函数、中间件这几个部分理清楚，就能写出结构清晰、易于扩展的服务了。

以上就是《Golang用net/http搭建Web服务器教程》的详细内容，更多关于中间件,net/http,GolangWeb服务器,http.ListenAndServe,http.HandleFunc的资料请关注golang学习网公众号！