Golang新手如何构建Web服务器使用net/http包创建基础API-Golang-PHP中文网

Golang新手如何构建Web服务器使用net/http包创建基础API

P粉602998670

发布： 2025-08-04 12:01:01

原创

319人浏览过

构建基础web服务器对golang新手并不难。1. 启动服务器只需调用http.listenandserve()，注册路由使用http.handlefunc并指定处理函数；2. 创建rest api需根据r.method处理get/post请求，返回json可用json.newencoder；3. 中间件可通过封装处理函数实现，如日志记录或cors支持；4. 路由管理可使用http.newservemux提升可控性并便于扩展。掌握这些核心点即可搭建结构清晰的api服务。

Golang新手如何构建Web服务器使用net/http包创建基础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请求。

立即学习“go语言免费学习笔记（深入）”；

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

登录后复制

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

Flawless AI

好莱坞2.0，电影制作领域的生成式AI工具

查看详情

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

登录后复制

这里我们创建了一个新的多路复用器