当前位置：首页 > 文章列表 > Golang > Go教程 > Golangnet/http实现REST路由方法

Golangnet/http实现REST路由方法

2026-01-15 17:38:54 0浏览收藏

今天golang学习网给大家带来了《Golang net/http实现REST路由方法》，其中涉及到的知识点包括等等，无论你是小白还是老手，都适合看一看哦~有好的建议也欢迎大家在评论留言，若是看完有所收获，也希望大家能多多点赞支持呀！一起加油学习~

Go语言通过net/http包可实现RESTful路由控制，利用http.ServeMux和自定义逻辑处理路径匹配与参数解析。1. 使用ServeMux注册GET、POST等方法路由，如/users和/users/123；2. 通过strings.TrimPrefix和strconv.Atoi提取路径参数ID；3. 封装registerUserRoutes函数按资源分组管理路由；4. 利用中间件包装函数实现日志、CORS等通用逻辑。该方式不依赖第三方库，结构清晰，适合小型项目或学习使用，复杂场景推荐Gin或Echo框架。

Golang使用net/http处理RESTful路由

Go语言的net/http包虽然没有内置的路由分组或参数解析功能，但通过标准库完全可以实现清晰的RESTful路由控制。关键在于合理组织http.HandleFunc或http.Handle，结合http.ServeMux和自定义逻辑，模拟出类似框架的路由行为。

使用ServeMux基础路由

Go内置的http.ServeMux可以匹配路径前缀和精确路径，适合简单REST接口。

例如，为用户资源定义基本路由：

GET /users 获取用户列表
POST /users 创建新用户
GET /users/123 获取ID为123的用户
PUT /users/123 更新用户
DELETE /users/123 删除用户

代码实现：

package main

import (
    "encoding/json"
    "net/http"
)

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

var users = []User{{ID: 1, Name: "Alice"}}

func usersHandler(w http.ResponseWriter, r *http.Request) {
    switch r.Method {
    case "GET":
        json.NewEncoder(w).Encode(users)
    case "POST":
        var user User
        json.NewDecoder(r.Body).Decode(&user)
        users = append(users, user)
        w.WriteHeader(http.StatusCreated)
    default:
        http.Error(w, "Method not allowed", http.StatusMethodNotAllowed)
    }
}

func userHandler(w http.ResponseWriter, r *http.Request) {
    // 简化：假设路径为 /users/1
    if r.Method == "GET" {
        json.NewEncoder(w).Encode(users[0])
    } else {
        http.Error(w, "Method not allowed", http.StatusMethodNotAllowed)
    }
}

func main() {
    mux := http.NewServeMux()
    mux.HandleFunc("GET /users", usersHandler)
    mux.HandleFunc("POST /users", usersHandler)
    mux.HandleFunc("GET /users/", userHandler) // 注意结尾斜杠匹配子路径

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

处理路径参数

net/http不支持像/users/{id}这样的动态路由，但可以通过字符串截取或正则提取ID。

在userHandler中提取ID：

func userHandler(w http.ResponseWriter, r *http.Request) {
    path := r.URL.Path
    idStr := strings.TrimPrefix(path, "/users/")
    id, err := strconv.Atoi(idStr)
    if err != nil {
        http.Error(w, "Invalid user ID", http.StatusBadRequest)
        return
    }

    // 查找用户等操作
    // ...
}

这种方式需要手动处理路径解析，适合轻量场景。

结构化路由组织

当接口变多时，建议按资源分组处理。可以封装一个简单的路由注册函数。

例如，定义一个路由注册器：

func registerUserRoutes(mux *http.ServeMux) {
    mux.HandleFunc("GET /users", getUsers)
    mux.HandleFunc("POST /users", createUser)
    mux.HandleFunc("GET /users/", getUser)
    mux.HandleFunc("PUT /users/", updateUser)
    mux.HandleFunc("DELETE /users/", deleteUser)
}

在main中调用registerUserRoutes(mux)，便于维护。

中间件与统一处理

通过包装函数添加日志、CORS、认证等逻辑。

func loggingMiddleware(next http.HandlerFunc) http.HandlerFunc {
    return func(w http.ResponseWriter, r *http.Request) {
        log.Printf("%s %s", r.Method, r.URL.Path)
        next(w, r)
    }
}

注册时使用：mux.HandleFunc("GET /users", loggingMiddleware(getUsers))

基本上就这些。用net/http实现RESTful路由不依赖第三方库，结构清晰，适合学习或小型项目。复杂场景建议使用Gin或Echo等框架提升开发效率。

终于介绍完啦！小伙伴们，这篇关于《Golangnet/http实现REST路由方法》的介绍应该让你收获多多了吧！欢迎大家收藏或分享给更多需要学习的朋友吧~golang学习网公众号也会发布Golang相关知识，快来关注吧！

路由 restful