Go语言使用net/http构建一个RESTful API的示例代码

更新时间：2025年08月12日 08:27:25 作者：程序员爱钓鱼

Go的标准库net/http提供了构建Web服务所需的强大功能,虽然众多第三方框架（如 Gin、Echo）已经封装了很多功能,但如果你真正想理解 Go的底层Web服务机制,那么使用net/http实现一个原生的RESTful API 是最好的入门方式,需要的朋友可以参考下本文

引言

Go 的标准库 net/http 提供了构建 Web 服务所需的强大功能。虽然众多第三方框架（如 Gin、Echo）已经封装了很多功能，但如果你真正想理解 Go 的底层 Web 服务机制，那么使用 net/http 实现一个原生的 RESTful API 是最好的入门方式。

本文将通过一个实战案例：构建一个用户信息管理 API，带你从零开始打造 RESTful 服务。

一、什么是 RESTful API？

REST（Representational State Transfer）是一种软件架构风格，常用于 Web API 的设计。

常见 HTTP 方法与操作语义：

方法	语义	说明
GET	获取资源	读取某个资源的内容
POST	创建资源	向服务器添加新资源
PUT	更新资源	修改已有资源
DELETE	删除资源	移除某个资源

二、实战目标：用户信息管理 API

我们将构建以下功能的 API：

GET /users：获取用户列表
GET /users/{id}：获取指定用户
POST /users：创建新用户
PUT /users/{id}：更新用户
DELETE /users/{id}：删除用户

三、代码实现

1. 用户数据结构

package main

import (
    "encoding/json"
    "fmt"
    "log"
    "math/rand"
    "net/http"
    "strconv"
    "strings"
    "sync"
)

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

var (
    users   = make(map[int]User)
    mu      sync.Mutex
)

2. 工具函数：ID提取

func parseID(path string) (int, error) {
    parts := strings.Split(path, "/")
    if len(parts) < 3 {
        return 0, fmt.Errorf("invalid path")
    }
    return strconv.Atoi(parts[2])
}

3. 处理函数

func usersHandler(w http.ResponseWriter, r *http.Request) {
    w.Header().Set("Content-Type", "application/json")

    switch r.Method {
    case "GET":
        // 获取所有用户
        mu.Lock()
        list := make([]User, 0, len(users))
        for _, user := range users {
            list = append(list, user)
        }
        mu.Unlock()
        json.NewEncoder(w).Encode(list)

    case "POST":
        // 创建用户
        var user User
        if err := json.NewDecoder(r.Body).Decode(&user); err != nil {
            http.Error(w, err.Error(), http.StatusBadRequest)
            return
        }
        user.ID = rand.Intn(10000)
        mu.Lock()
        users[user.ID] = user
        mu.Unlock()
        json.NewEncoder(w).Encode(user)

    default:
        http.Error(w, "Method Not Allowed", http.StatusMethodNotAllowed)
    }
}

func userHandler(w http.ResponseWriter, r *http.Request) {
    w.Header().Set("Content-Type", "application/json")

    id, err := parseID(r.URL.Path)
    if err != nil {
        http.Error(w, "Invalid ID", http.StatusBadRequest)
        return
    }

    mu.Lock()
    user, exists := users[id]
    mu.Unlock()

    switch r.Method {
    case "GET":
        if !exists {
            http.NotFound(w, r)
            return
        }
        json.NewEncoder(w).Encode(user)

    case "PUT":
        if !exists {
            http.NotFound(w, r)
            return
        }
        var updated User
        if err := json.NewDecoder(r.Body).Decode(&updated); err != nil {
            http.Error(w, err.Error(), http.StatusBadRequest)
            return
        }
        updated.ID = id
        mu.Lock()
        users[id] = updated
        mu.Unlock()
        json.NewEncoder(w).Encode(updated)

    case "DELETE":
        if !exists {
            http.NotFound(w, r)
            return
        }
        mu.Lock()
        delete(users, id)
        mu.Unlock()
        w.WriteHeader(http.StatusNoContent)

    default:
        http.Error(w, "Method Not Allowed", http.StatusMethodNotAllowed)
    }
}

4. 主函数启动服务

func main() {
    http.HandleFunc("/users", usersHandler)
    http.HandleFunc("/users/", userHandler)

    fmt.Println("服务启动中： http://localhost:8080")
    log.Fatal(http.ListenAndServe(":8080", nil))
}

四、测试方式（推荐使用 curl 或 Postman）

# 创建用户
curl -X POST -H "Content-Type: application/json" \
     -d '{"name":"Tom","age":25}' http://localhost:8080/users

# 获取所有用户
curl http://localhost:8080/users

# 获取指定用户
curl http://localhost:8080/users/1234

# 更新用户
curl -X PUT -H "Content-Type: application/json" \
     -d '{"name":"Jerry","age":30}' http://localhost:8080/users/1234

# 删除用户
curl -X DELETE http://localhost:8080/users/1234

五、总结与建议

通过本案例，我们学习了如何用 Go 原生的 net/http：

✅ 实现 RESTful 风格的接口
✅ 处理不同的 HTTP 方法
✅ 编解码 JSON 数据
✅ 线程安全地管理数据结构

虽然这个例子是最基础的，但它奠定了你进一步使用更强大框架（如 Gin、Echo）的基础。

六、进阶推荐

加入中间件（如日志、认证）
使用 context 处理请求生命周期
支持 URL 参数和 Query 参数
使用第三方路由库如 gorilla/mux
数据存储替换为数据库（如 GORM + MySQL）

以上就是Go语言使用net/http构建一个RESTful API的示例代码的详细内容，更多关于Go net/http构建RESTful API的资料请关注脚本之家其它相关文章！

您可能感兴趣的文章:

go语言import报错处理图文详解
今天本来想尝试一下go语言中公有和私有的方法,结果import其他包的时候直接报错了,下面这篇文章主要给大家介绍了关于go语言import报错处理的相关资料,需要的朋友可以参考下
2023-04-04
使用Go语言编写一个毫秒级生成组件库文档工具
在开发组件库的过程中,文档无疑是不可或缺的一环,在本文中将尝试将Go语言与前端技术巧妙融合,以创建一款能在毫秒级别完成文档生成的工具,需要的可以参考下
2024-03-03
GoLang抽奖系统简易实现流程
这篇文章主要介绍了GoLang抽奖系统实现流程，文中通过示例代码介绍的非常详细，对大家的学习或者工作具有一定的参考学习价值，需要的朋友们下面随着小编来一起学习吧
2022-12-12
优雅使用GoFrame共享变量Context示例详解
这篇文章主要为大家介绍了优雅使用GoFrame共享变量Context示例详解，有需要的朋友可以借鉴参考下，希望能够有所帮助，祝大家多多进步，早日升职加薪
2022-06-06
Go语言如何利用Mutex保障数据读写正确
这篇文章主要介绍了互斥锁的实现机制，以及 Go 标准库的互斥锁 Mutex 的基本使用方法，文中的示例代码讲解详细，需要的小伙伴可以参考一下
2023-05-05
Golang接口使用教程详解
在 Go 语言中接口包含两种含义:它既是方法的集合, 同时还是一种类型并且在Go 语言中是隐式实现的。本文通过示例详细介绍了Golang接口的使用，需要的可以参考一下
2022-09-09
golang封装一个执行命令行的函数(return stderr/stdout/exitcode)示例代码
在 Go 语言中,您可以使用 os/exec 包来执行外部命令,不通过调用 shell,并且能够获得进程的退出码、标准输出和标准错误输出,下面给大家分享golang封装一个执行命令行的函数(return stderr/stdout/exitcode)的方法,感兴趣的朋友跟随小编一起看看吧
2024-06-06
Go语言中的goroutine和channel如何协同工作
在Go语言中,goroutine和channel是并发编程的两个核心概念,它们协同工作以实现高效、安全的并发执行,本文将详细探讨goroutine和channel如何协同工作,以及它们在并发编程中的作用和优势,需要的朋友可以参考下
2024-04-04
golang中的空slice案例
这篇文章主要介绍了golang中的空slice案例，具有很好的参考价值，希望对大家有所帮助。一起跟随小编过来看看吧
2021-04-04
golang构建工具Makefile使用详解
这篇文章主要为大家介绍了golang构建工具Makefile的使用详解，有需要的朋友可以借鉴参考下，希望能够有所帮助，祝大家多多进步，早日升职加薪
2022-07-07