首页 > Golang > Go教程

GolangHTTP请求处理实战教程

时间：2025-10-11 22:43:48 155浏览收藏

**Golang HTTP请求处理实战案例：快速上手API服务开发** 本文通过一个简易的待办事项（Todo）API实战案例，助您快速掌握Golang HTTP服务开发。我们将使用Go语言实现获取所有事项、添加新事项以及标记完成状态等核心功能。通过定义`Todo`结构体和内存切片模拟数据存储，并结合`net/http`包处理路由和JSON响应，构建一个基础但完整的HTTP服务。本教程适合初学者，旨在帮助您理解路由、请求处理、JSON数据交互和简单的业务逻辑，从而为更复杂的Golang Web应用开发打下坚实基础。立即开始，轻松搭建您的第一个Golang API服务！

答案：从创建简易待办事项API入手，使用Go语言实现获取所有事项、添加新事项及标记完成状态功能，通过定义Todo结构体与内存切片模拟数据存储，结合net/http包处理路由与JSON响应，适合初学者快速掌握Golang HTTP服务基础。

Golang初级HTTP请求处理项目案例

想快速上手 Golang 的 HTTP 请求处理？从一个简单的 API 服务开始最合适。下面是一个基础但完整的 Golang HTTP 项目案例，适合初学者理解路由、请求处理、JSON 响应和简单业务逻辑。

项目目标

搭建一个简易的“待办事项”（Todo）API，支持以下功能：

获取所有待办事项
添加新的待办事项
根据 ID 标记为完成

项目结构

项目目录结构简洁：

todo-api/
├── main.go
└── go.mod

初始化项目

创建项目目录并初始化模块：

mkdir todo-api
cd todo-api
go mod init todo-api

定义数据结构

在 main.go 中定义 Todo 结构体和内存存储（用切片模拟数据库）：

package main import ( "encoding/json" "log" "net/http" "strconv" ) type Todo struct { ID int `json:"id"` Title string `json:"title"` Done bool `json:"done"` } var todos = []Todo{ {ID: 1, Title: "学习 Go 基础", Done: false}, {ID: 2, Title: "写一个 HTTP 服务", Done: true}, }

实现 HTTP 处理函数

编写三个处理函数：

获取所有待办事项

func getTodos(w http.ResponseWriter, r *http.Request) { w.Header().Set("Content-Type", "application/json") json.NewEncoder(w).Encode(todos) }

添加新的待办事项

func createTodo(w http.ResponseWriter, r *http.Request) { if r.Method != "POST" { http.Error(w, "只支持 POST 方法", http.StatusMethodNotAllowed) return } var newTodo Todo if err := json.NewDecoder(r.Body).Decode(&newTodo); err != nil { http.Error(w, "请求体格式错误", http.StatusBadRequest) return } newTodo.ID = len(todos) + 1 todos = append(todos, newTodo) w.Header().Set("Content-Type", "application/json") w.WriteHeader(http.StatusCreated) json.NewEncoder(w).Encode(newTodo) }

标记为完成

func completeTodo(w http.ResponseWriter, r *http.Request) { idStr := r.URL.Query().Get("id") id, err := strconv.Atoi(idStr) if err != nil || id

注册路由并启动服务

在 main 函数中设置路由和启动服务器：

func main() { http.HandleFunc("/todos", func(w http.ResponseWriter, r *http.Request) { if r.Method == "GET" { getTodos(w, r) } else if r.Method == "POST" { createTodo(w, r) } else { http.Error(w, "不支持的方法", http.StatusMethodNotAllowed) } }) http.HandleFunc("/complete", completeTodo) log.Println("服务器启动在 http://localhost:8080") log.Fatal(http.ListenAndServe(":8080", nil)) }

测试 API

启动服务：

go run main.go

使用 curl 测试：

获取所有任务：
curl http://localhost:8080/todos
添加新任务：
curl -X POST -H "Content-Type: application/json" -d '{"title":"测试添加"}' http://localhost:8080/todos
标记完成：
curl -X GET http://localhost:8080/complete?id=1

小结

这个项目涵盖了 Golang HTTP 开发的核心知识点：使用 net/http 包处理请求、解析 JSON、设置响应头、简单的路由分发和错误处理。虽然没有用到第三方框架，但足以帮助理解底层机制。后续可扩展数据库、中间件、验证等功能。

基本上就这些，不复杂但容易忽略细节，比如 Content-Type 和状态码的设置。动手改改，加个删除功能试试？

终于介绍完啦！小伙伴们，这篇关于《GolangHTTP请求处理实战教程》的介绍应该让你收获多多了吧！欢迎大家收藏或分享给更多需要学习的朋友吧~golang学习网公众号也会发布Golang相关知识，快来关注吧！

golang API JSON net/http HTTP服务