首页 > Golang > Go教程

Golang搭建RESTful服务入门教程

时间：2025-10-11 18:25:50 308浏览收藏

本教程旨在指导开发者使用Golang标准库快速构建基础的RESTful服务。无需依赖第三方框架，通过`net/http`包，我们将一步步讲解如何定义数据模型（例如User结构体），创建CRUD（创建、读取、更新、删除）处理函数，并在主函数中注册路由，最终启动一个简单的HTTP服务器，实现用户管理接口。示例代码结构清晰，易于理解，特别适合Golang Web服务初学者掌握底层机制和核心流程。通过本文，你将学会如何处理HTTP请求，进行JSON数据交互，并搭建一个可扩展的RESTful API基础架构。立即开始你的Golang RESTful服务之旅！

答案：使用Golang标准库net/http可实现基础RESTful服务，通过定义User模型、创建CRUD处理函数并在main中注册路由，启动HTTP服务器完成用户管理接口。

Golang实现基础RESTful服务项目

用Golang实现一个基础的RESTful服务并不复杂，核心在于路由控制、HTTP处理和数据交互。下面是一个简单但完整的示例，使用标准库net/http来构建，不依赖第三方框架（如Gin或Echo），适合初学者理解底层机制。

项目结构

一个清晰的小项目结构有助于维护：

├── main.go
├── handlers.go
├── models.go
└── go.mod

定义数据模型

在models.go中定义结构体，比如我们做一个简单的用户管理：

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

同时初始化一个切片模拟存储：

var users []User
var nextID = 1

编写处理函数

在handlers.go中实现CRUD操作：

// 获取所有用户
func GetUsers(w http.ResponseWriter, r *http.Request) {
w.Header().Set("Content-Type", "application/json")
json.NewEncoder(w).Encode(users)
}

// 创建用户
func CreateUser(w http.ResponseWriter, r *http.Request) {
  var user User
  if err := json.NewDecoder(r.Body).Decode(&user); err != nil {
    http.Error(w, "无效的请求体", http.StatusBadRequest)
    return
  }
  user.ID = nextID
  nextID++
  users = append(users, user)
  w.Header().Set("Content-Type", "application/json")
  w.WriteHeader(http.StatusCreated)
  json.NewEncoder(w).Encode(user)
}

// 获取单个用户
func GetUser(w http.ResponseWriter, r *http.Request) {
  id, := strconv.Atoi(r.URL.Path[len("/users/"):])
  for , u := range users {
    if u.ID == id {
      w.Header().Set("Content-Type", "application/json")
      json.NewEncoder(w).Encode(u)
      return
    }
  }
  http.Error(w, "用户未找到", http.StatusNotFound)
}

主函数启动服务

在main.go中注册路由并启动服务器：

func main() {
  http.HandleFunc("/users", func(w http.ResponseWriter, r *http.Request) {
    if r.Method == "GET" {
      GetUsers(w, r)
    } else if r.Method == "POST" {
      CreateUser(w, r)
    }
  })

  http.HandleFunc("/users/", func(w http.ResponseWriter, r *http.Request) {
    if r.Method == "GET" {
      GetUser(w, r)
    }
  })

  fmt.Println("服务器启动在 :8080")
  log.Fatal(http.ListenAndServe(":8080", nil))
}

别忘了在项目根目录运行go mod init your-project-name生成模块文件。