今天进入Day 4,总算到了后端绕不开的核心话题——数据层。前面三天把环境、HTTP服务、路由这些地基打好了,但一个只会在内存里读写数据的后端,跑不了几天就得重构。今天这篇,我们全力解决“数据怎么落库、怎么查出来、怎么改回去”的问题,主角就是Go标准库里的database/sql,以及基于它实现的增删改查(CRUD)。
database/sql是Go官方提供的数据库操作统一入口,它本身不是某个具体数据库的驱动,而是一套标准接口。你只需要按它的规则写代码,再配合对应的驱动(我们用的是MySQL驱动),就能完成建表后的所有读写操作。这篇文章适合刚入门Go后端、已经会写基础HTTP接口、但对数据库操作还比较陌生的同学。看完之后,你能独立写出一套完整的用户表增删改查接口,也知道连接池、事务、防SQL注入这些“高级话题”到底是怎么回事。
1. 数据层入门前:先搞清楚它到底在管什么
1.1 数据层不是“连上数据库”,而是“数据的守门人”
很多新手容易有个误解,觉得数据层就是把数据库连上,然后写几句SQL,完事。其实数据层远不止“连接”这一件事,它是整条请求链路里最靠近存储的关卡。
先说清楚一个请求在后端大致走的路:
code复制HTTP Handler → Service/业务逻辑 → 数据层(Data Access) → 数据库
前端发来一个“创建用户”的请求,Handler负责解析参数和校验格式,Service负责处理业务规则(比如密码加密、用户名是否重复),真正跟数据库打交道的是数据层。数据层要做的事情包括:构造SQL语句、绑定参数、执行查询、把结果映射成Go结构体、处理查询过程中的异常。
我用一个日常类比帮大家理解:如果你把数据库比作一个巨大的仓库,那么数据层就是仓库门口的“管理员”。管理员负责登记谁要拿什么、拿多少、拿完放回哪里。它不关心货物到了前台怎么摆(那是业务层的事),但所有进出仓库的动作都必须在它这里走一遍。没有这层管理,代码里到处直接写SQL,今天一个写法、明天一个写法,后期改表结构、加缓存、切数据库,全都变成灾难。
这正好解释了为什么很多Go项目即使很小,也会单独把数据访问抽出来。Day 4我们不搞复杂分层,但至少要在脑子里有这个概念:数据层是独立的、被业务代码调用的、统一管理数据库会话的一层。
1.2 为什么不直接上GORM?标准库的价值不可替代
市面上Go的ORM库不少,GORM是最出名的一个。很多教程会直接教GORM,天天User.Find(1)、db.Create(&user),写起来确实爽。那为什么我建议Day 4先老老实实把database/sql过一遍?
先说结论:不是GORM不好,而是新手直接学ORM,很容易变成“只会调用API,不懂底层SQL”。比如GORM的db.Where("email = ?", email).First(&user),底层生成的SQL是什么?如果查询条件拼错了,GORM报的错提示的是它自己封装后的错误,你能不能一眼看出是SQL语法问题还是参数类型问题?我见过不少同学,在GORM里遇到“record not found”就懵了,不知道这是数据库查不到数据还是连接断了。根源就是不懂database/sql层的错误模型。
再往深一层说,ORM解决的痛点是“对象-关系映射”,但Go的标准库database/sql已经帮你处理了连接管理、预编译、结果扫描这些最繁琐的部分,剩下的其实就那么几个方法:Exec、Query、QueryRow。这个学习曲线比直接跳进GORM要平滑得多。等你把database/sql的CRUD写顺了,再回头看GORM的文档,一眼就能看懂它封装了什么、省了什么、哪些地方可能埋了坑。
我用个表格把两者差异列出来:
| 维度 | database/sql | GORM |
|---|---|---|
| 上手成本 | 需要自己写SQL,但模式固定 | 方法调用简单,但概念多 |
| SQL可控性 | 完全可控,SQL写什么就是什么 | 通过链式调用生成,复杂SQL需要Raw |
| 错误模型 | 直观,sql.ErrNoRows等清晰 | 包装后的错误,需熟悉ErrRecordNotFound |
| 性能开销 | 最直接,几乎无额外损耗 | 有反射和中间层开销 |
| 适用场景 | 一切需要精细控制SQL的场景 | 快速CRUD、模型关系简单、不太在意底层 |
当然,项目做大了之后,直接写SQL的重复劳动会增多,这时候按需引入GORM或者sqlc这类工具是合理的。但那是“选型”的问题,不是“学习路径”的问题。先把标准库吃透,后面不管换什么工具,你都知道它底层在干什么,不会被框架绑死。
需要模型API调用? 免费领10W Token,多模型网关一键接入 Claude、DeepSeek 等主流模型。
2. 动手准备:从建库建表到连接池调优
2.1 建库建表:一个用户表就够了
开始写代码之前,先去本地把数据库准备好。我用的是MySQL,如果你用的是PostgreSQL或者SQLite,思路完全一致,只是驱动和占位符略有差别(PostgreSQL用$1、$2,MySQL和SQLite用?)。
先建一个库,再建一张用户表:
sql复制CREATE DATABASE IF NOT EXISTS demo
DEFAULT CHARACTER SET utf8mb4
COLLATE utf8mb4_unicode_ci;
USE demo;
CREATE TABLE IF NOT EXISTS users (
id BIGINT NOT NULL AUTO_INCREMENT COMMENT '主键',
name VARCHAR(64) NOT NULL COMMENT '用户名',
email VARCHAR(128) NOT NULL COMMENT '邮箱',
created_at DATETIME NOT N
