用 net/http 实现最简 Todo 服务需三步:注册路由、解析参数(Query/JSON)、JSON 响应;注意 struct 字段导出与 json tag、并发用 sync.RWMutex、ID 校验返回 404。

用 net/http 启动最简 Todo 服务,别急着上框架
Go 写 Todo 不需要 Gin、Echo 或数据库——先用内存 map + net/http 跑通流程。很多初学者卡在“怎么把请求参数取出来”,其实核心就三步:http.HandleFunc 注册路由、用 r.ParseForm() 或 r.URL.Query() 读参数、用 json.NewEncoder(w).Encode() 返回 JSON。
-
POST /todos:用r.Body+json.Decode()解析 JSON 请求体,别漏了defer r.Body.Close() -
GET /todos:直接遍历内存 map,不用查库,响应前设w.Header().Set("Content-Type", "application/json") - 路径带 ID 的(如
GET /todos/123),用strings.TrimPrefix(r.URL.Path, "/todos/")提取,别硬写正则
func handlerTodos(w http.ResponseWriter, r *http.Request) {
w.Header().Set("Content-Type", "application/json")
switch r.Method {
case "GET":
json.NewEncoder(w).Encode(todos)
case "POST":
var t Todo
if err := json.NewDecoder(r.Body).Decode(&t); err != nil {
http.Error(w, err.Error(), http.StatusBadRequest)
return
}
t.ID = nextID()
todos[t.ID] = t
w.WriteHeader(http.StatusCreated)
json.NewEncoder(w).Encode(t)
}
}
struct 字段必须导出且加 json: tag,否则序列化为空
Go 的 JSON 编解码只处理首字母大写的导出字段,且默认用字段名小写作 key。如果你定义 type Todo struct { title string },json.Marshal() 出来永远是 {} —— 看似没报错,实则丢数据。
- 正确写法:
type Todo struct { ID int `json:"id"` Title string `json:"title"` Done bool `json:"done"` } -
Done bool默认为false,前端传{"done": null}不会覆盖,得显式传true或false - 如果想支持部分更新(PATCH),别直接 decode 到 struct,改用
map[string]interface{}或第三方库如mapstructure
内存 map 并发不安全,sync.RWMutex 是最低成本方案
本地测试时用 map[int]Todo 很方便,但一旦并发请求(比如两个 POST 同时进来),就会触发 fatal error: concurrent map writes。不用上 Redis 或 SQL,加一把读写锁就能跑稳。
- 声明全局变量:
var ( mu sync.RWMutex; todos = make(map[int]Todo) ) - 读操作(GET /todos)用
mu.RLock()/mu.RUnlock() - 写操作(POST/PUT/DELETE)用
mu.Lock()/mu.Unlock() - 别把锁粒度搞太大——比如在
handlerTodos开头就mu.Lock(),然后整个函数执行完才释放,会严重拖慢并发能力
删除和更新要校验 ID 是否存在,404 比 panic 更合理
用户访问 DELETE /todos/999,后端直接 panic 或返回空响应,前端无法区分“删成功了”还是“ID 不存在”。必须显式检查 map 中是否存在该 key,并返回对应 HTTP 状态码。
立即学习“go语言免费学习笔记(深入)”;
-
DELETE /todos/{id}:先mu.RLock()查,存在再mu.Lock()删除,不存在返回http.StatusNotFound -
PUT /todos/{id}:同样先查,不存在应返回 404;若允许创建新项,需明确文档说明,而非静默处理 - 错误响应也走 JSON:
json.NewEncoder(w).Encode(map[string]string{"error": "todo not found"}),保持前后端约定一致
真正难的不是写增删改查,而是决定什么时候该扔掉内存 map——比如重启进程数据就没了,这时候才需要 SQLite 或 PostgreSQL。先让逻辑跑通,再考虑持久化,别一上来就折腾 GORM 迁移和连接池。










