Golang简单博客后端开发教程

本文是一份面向初学者的Golang博客后端实战指南，主张“去框架化”开发：用原生net/http搭建轻量路由、html/template渲染页面、database/sql直连SQLite管理数据、json.Marshal统一API输出，并通过go run快速启动调试；全文聚焦真实踩坑经验——从手动解析URL路径、字段类型严格匹配、时间格式规范，到JSON序列化细节、事务控制和工作目录陷阱，强调用最简可控的工具链快速跑通核心功能，避免过早陷入框架抽象与工程化负担，真正实现“先能跑，再迭代”。

用 net/http 搭个能跑的路由骨架，别急着上框架

刚写 Go Web 服务，最容易掉进「先选框架」的坑里。其实 net/http 自带的 http.ServeMux 足够撑起博客后端的初期路由——它轻、没隐藏逻辑、出错时堆栈干净。gin 或 echo 的中间件链、反射路由在调试时反而会模糊真实调用路径。

实操建议：

• 用 http.HandleFunc 注册 /posts、/posts/{id} 这类明确路径，先不用通配符或正则；{id} 实际得靠 strings.Split(r.URL.Path, "/") 手动解析，别指望自动绑定
• 所有 handler 函数签名必须是 func(http.ResponseWriter, *http.Request)，返回值不能加 error —— 错误要自己写入 ResponseWriter 并设状态码（比如 w.WriteHeader(http.StatusNotFound)）
• 别在 handler 里直接拼 HTML 字符串返回，先用 html/template 加载 .html 文件，哪怕模板只有一行 {{.Title}}

用 database/sql + sqlite3 存文章，绕过 ORM 复杂度

博客数据结构简单（标题、内容、发布时间），强行上 GORM 或 ent 会把 3 行 SQL 变成 15 行配置+结构体标签+迁移命令。而 database/sql 配合 github.com/mattn/go-sqlite3 驱动，写起来更接近你脑子里想的 SQL。

常见错误现象：执行 INSERT 后查不到数据，或者 SELECT 返回空结构体。

原因和对策：

• db.QueryRow("SELECT ...").Scan(&v) 时，变量 v 类型必须和 SELECT 字段类型严格匹配（比如 SQLite 的 INTEGER 对应 Go 的 int64，不是 int）
• 插入时间字段别用 time.Now().String()，改用 time.Now().Format("2006-01-02 15:04:05")，SQLite 才认这个格式
• 事务不是默认开启的，db.Exec("INSERT ...") 是自动提交的；如果要做「插入文章+插入标签」原子操作，得显式调用 tx, _ := db.Begin()，再 tx.Exec，最后 tx.Commit()

用 json.Marshal 直接输出 API，别碰 encoding/xml 或自定义序列化

博客后端初期只要支持两种输出：浏览器访问返回 HTML 页面，curl -H "Accept: application/json" 访问返回 JSON。这时别写两套渲染逻辑，用一个结构体 + json.Marshal 覆盖全部。

使用场景：前端用 Fetch 请求 /api/posts，后端就该返回标准 JSON 数组，而不是 HTML 片段或带

 包裹的字符串。

参数差异和坑点：
结构体字段名首字母必须大写才能被 json.Marshal 导出，小写字段永远是空值
时间字段默认序列化成长数字（Unix 时间戳），加 json:"created_at,string" tag 才变成可读字符串
空字符串、零值字段会出现在 JSON 里，加 json:",omitempty" 可跳过，但注意：指针字段为 nil 时才跳过，"" 不算 omitempty
用 go run main.go 启动，别急着写 Dockerfile 或 systemd 服务
本地开发阶段，最大的干扰来自「部署层抽象」。写好 main.go 后直接 go run main.go，配合 kill -HUP $(pidof ./blog) 热重启，比折腾 air 或 fresh 工具更可控。
性能与兼容性影响：
Go 默认 HTTP 服务器并发模型是每个请求一个 goroutine，对博客这种 QPS http.Server.ReadTimeout 等参数
SQLite 数据库文件路径写成相对路径（如 ./data/blog.db），确保 go run 执行时工作目录正确，否则打开失败报 no such file or directory
如果要用 HTTPS 本地测试，别生成证书，改用 http.ListenAndServeTLS(":8080", "cert.pem", "key.pem", nil) 占位，等上线再补真实证书
真正卡住进度的，往往不是语法或框架不会用，而是花半天调通 SQLite 的 busy timeout 或搞不清 template.ParseFiles 的路径查找规则。先让 GET /posts 返回三篇文章的 JSON，再一点点加功能，比一上来就设计「用户权限模块」实在得多。
好了，本文到此结束，带大家了解了《Golang简单博客后端开发教程》，希望本文对你有所帮助！关注golang学习网公众号，给大家分享更多Golang知识！