后端开发做久了你会发现,代码里最绕不开的那块不是 HTTP 路由,也不是框架 API,而是数据层。接口写得再漂亮,最后还是要落库、查库、改库、删库。Day 4 这个位置刚好是整个系列的关键转折点:前面几天你把 Go 的语法、HTTP 服务、路由和中间件都打通了,从今天开始,项目开始真正“有数据”了。这一篇我会用 Go 标准库 database/sql 把一张 user 表从建表到增删改查完整走一遍,顺带把连接池、事务、常见炸点全部讲清楚。适合刚入门 Go 后端、知道怎么启动 HTTP 服务但还没系统碰过数据库的读者。
1. 数据层在后端项目里的位置,以及为什么先碰 database/sql
1.1 一个请求从接口到数据库,到底走了几层
很多新手对“后端提供接口”这件事的理解停留在路由和函数上:前端请求 /api/users,后端某个 handler 收到请求,返回一段 JSON。但项目一旦真实跑起来,你会发现这个链路在代码层面至少要拆成好几层。
以我这个系列的教学项目为例,目前就是这样分层的:
handler层:负责解析 HTTP 请求、读取参数、校验输入、组装响应。service层:负责业务规则,比如“用户名不能为空”“邮箱不允许重复”,这层不一定每个项目都有,但上了规模基本都会加。store层:也有人叫dao或repository,它只做一件事,就是和数据库打交道,把数据读出来、写进去。db层:真正的数据库连接与连接池,由 store 层使用。
Day 4 的核心就在后面的两层。你前端界面上看到的用户列表、详情、删除结果,最终都落在几条 SQL 语句上。把数据层从 HTTP 逻辑里拆出来,最大的好处是职责清晰:handler 不用关心数据存哪,store 不用关心请求从哪来,两边各自好测、好改。
从学习顺序上,我建议你先把 store 层练熟,再回去调整 handler。因为数据操作是后端最实在的硬功夫,一旦你掌握了 CRUD,后面的接口基本就是“把 store 的返回值包成 JSON”而已。
1.2 不急着上 ORM,先把 database/sql 吃透
现在的 Go 生态里,GORM、sqlx 这类库用起来确实爽,结构体一标,增删改查自动生成,代码量能少一大半。但我在这套 7 天实战里故意不用 ORM,开头几天就老老实实写标准库,原因有三个。
第一个原因,标准库帮你把数据库驱动和连接池这些脏活累活都干了,你只需要关心 SQL 本身,这反而能让你把 SQL 写明白。很多用了两年 ORM 的开发者,遇到复杂查询还是得回头补原生 SQL,早学早省事。
第二个原因,理解 database/sql 的工作方式,你才能理解 ORM 底层到底替你做了什么,以后排查问题不至于两眼一抹黑。比如 GORM 报 sql: database is closed 时,你能瞬间反应过来是连接池或者 db 实例生命周期出了问题,而不是对着报错瞎猜。
第三个原因,标准库足够稳定。database/sql 从 Go 1.1 开始就有了,接口设计这么多年没大改,你学会这套写法,换数据库、换框架都不会过时。后面真要引入 GORM 或者 sqlx,再看它们的文档会轻松很多,因为核心概念是相通的:连接、查询、扫描、释放。
我这么说不是在贬低 ORM,生产项目里我也用 GORM。但 Day 4 这个阶段,老老实实写几天原生 SQL,你会比别人少踩很多隐形的坑。
需要模型API调用? 免费领10W Token,多模型网关一键接入 Claude、DeepSeek 等主流模型。
2. 环境准备与数据库连接:先把地基打牢
2.1 数据库选型与建库:我为什么先用 MySQL
Go 的 database/sql 是标准接口,理论上支持所有关系型数据库,但不同数据库驱动、语法细节有差异。为了贴近真实后端项目场景,我这里选 MySQL,原因很直接:国内后端岗位最常见的就是 MySQL,网上资料多,部署方便,你以后工作大概率也绕不开。
如果手头暂时没有 MySQL 服务,两个选择:一是装一个 Docker 容器,docker run -d -p 3306:3306 -e MYSQL_ROOT_PASSWORD=你的密码 mysql:8,几秒钟就能跑起来;二是本地直接装 MySQL 8.x,Windows 和 macOS 都有安装包。实在不想装 MySQL,用 SQLite 也能跑通下面的代码,驱动换成 github.com/mattn/go-sqlite3,SQL 语法大部分兼容,但为了不偏题,这篇统一按 MySQL 讲。
建库这一步很简单,我一般会单独建一个库给当前项目用,避免和本地其他项目的数据混在一起。顺手把字符集指定成 utf8mb4,不然以后存 emoji 或者生僻字会报错:
sql复制CREATE DATABASE IF NOT EXISTS go_crud
DEFAULT CHARACTER SET utf8mb4
DEFAULT COLLATE utf8mb4_general_ci;
USE go_crud;
这里有个小经验:建库的时候把排序规则也一起定好。utf8mb4 只解决字符存储问题,排序规则决定字符串比较的行为,比如邮箱查询是否区分大小写。一般项目用 utf8mb4_general_ci 就够了,追求更精确的 Unicode 排序可以选 utf8mb4_unicode_ci,性能差异在这个量级几乎感觉不到。
2.2 驱动引入与连接串配置
Go 语言的 database/sql 只是一层抽象接口,真正和 MySQL 通信的是驱动。最常用的是 github.com/go-sql-driver/mysql,这个驱动质量很高,也是官方文档推荐的。安装命令:
bash复制go get -u github.com/go-sql-driver/mysql
引入方式有个特点,必须是匿名导入:
go复制import (
"database/sql"
_ "github.com/go-sql-driver/mysql"
)
那个空的 _ 就是为了让驱动在 init() 里把自己注册到 database/sql,这样 sql.Open("mysql", dsn) 才能识别。如果你忘了这行匿名导入,运行时不会报编译错误,但一执行就会看到 panic: sql: unknown driver "mysql",这个我在第 4 节还会专门提。
DSN(Data Source Name)是连接串的核心,格式如下:
go复制dsn := "root:你自己的密码@tcp(127.0.0.1:3306)/go_crud?charset=utf8mb4&parseTime=True&loc=Local"
参数拆开看:
root:密码:用户名和密码。@tcp(127.0.0.1:3306):网络
