用 net/http 可快速搭建结构清晰的博客后端骨架:先硬编码 Post 结构体与测试数据,实现 /posts GET 返回 JSON;POST 创建时需区分 Content-Type,JSON 用 io.ReadAll + json.Unmarshal,表单用 ParseForm;推荐 gorilla/mux 支持路径参数如 /posts/{id};初期 SQLite 零配置够用;全程需严谨错误处理。

用 net/http 搭一个可运行的博客后端骨架
不需要框架也能起步,net/http 足够支撑博客后端基础路由和数据响应。重点不是“多快”,而是“结构清晰、能加功能”。先跑通一条路径:访问 /posts 返回 JSON 列表。
- 定义简单结构体:
type Post struct { ID int `json:"id"` Title string `json:"title"` Content string `json:"content"` } - 硬编码几条测试数据,避免早期引入数据库复杂度
- 注册路由:
http.HandleFunc("/posts", listPostsHandler),handler 内用json.NewEncoder(w).Encode(posts)输出 - 启动服务:
http.ListenAndServe(":8080", nil),立刻可用curl http://localhost:8080/posts验证
处理 POST 请求写入新文章时要注意 ParseForm 和 Body 的区别
前端发 application/json 还是 application/x-www-form-urlencoded,后端读取方式完全不同,错配就会收不到数据。
- 如果是 JSON(推荐):必须用
io.ReadAll(r.Body)读原始字节,再json.Unmarshal;r.ParseForm()对它无效 - 如果是表单:调
r.ParseForm()后,用r.FormValue("title")取值;此时不能重复读r.Body - 忘记调
defer r.Body.Close()会导致连接泄漏,尤其在本地反复测试时容易卡住 - 示例中建议统一用 JSON,更贴近现代前端习惯
func createPostHandler(w http.ResponseWriter, r *http.Request) {
if r.Method != "POST" {
http.Error(w, "Method not allowed", http.StatusMethodNotAllowed)
return
}
defer r.Body.Close()
body, _ := io.ReadAll(r.Body)
var p Post
json.Unmarshal(body, &p)
// ...保存逻辑
w.WriteHeader(http.StatusCreated)
json.NewEncoder(w).Encode(p)
}
用 gorilla/mux 替代默认 multiplexer 是为了支持路径参数和中间件
net/http 默认路由不支持 /posts/{id} 这种写法,硬写字符串匹配易出错。而博客必然需要按 ID 查单篇,这时 gorilla/mux 就很实在。
- 安装:
go get -u github.com/gorilla/mux - 替换路由注册:
r := mux.NewRouter(),然后r.HandleFunc("/posts/{id}", getPostHandler).Methods("GET") - 在 handler 中用
vars := mux.Vars(r)取vars["id"],再转成整数 - 后续加日志、鉴权等中间件也基于它,不用自己重造轮子
数据库选 SQLite 而不是 MySQL/PostgreSQL 是因为零配置和文件级迁移
初期连用户系统都还没做,没必要搭完整数据库服务。SQLite 直接读写一个 blog.db 文件,go-sqlite3 驱动成熟,迁移成本几乎为零。
立即学习“go语言免费学习笔记(深入)”;
- 建表 SQL 一句搞定:
CREATE TABLE posts (id INTEGER PRIMARY KEY AUTOINCREMENT, title TEXT, content TEXT) - 插入用
db.Exec("INSERT INTO posts(title,content) VALUES(?,?)", title, content),问号防注入 - 查询单条:
db.QueryRow("SELECT id,title,content FROM posts WHERE id = ?", id).Scan(&p.ID, &p.Title, &p.Content) - 注意:SQLite 不支持并发写,但博客后台写操作极少,够用
真正卡点不在技术选型,而在把「新增文章 → 存库 → 返回 JSON」这条链路每个环节都加错误判断,比如 if err != nil { http.Error(w, err.Error(), http.StatusInternalServerError) }。漏掉一处,前端就只看到 500,查不出哪错了。










