
Hello,我是小兔大白糖。 业务 Service 里直接 collection.Find / db.Query,第一周写得飞快;第二个月单测要么起真库,要么 mock 半个驱动;换存储或加一层缓存时,用例文件跟着炸。写成这篇,给要做 应用服务与持久化边界 调研的初中级后端同学:不是某仓库的搬家工单,而是业界可复述的 Repository(仓储)心智模型。
说明:下文接口名、伪流程均为教学脱敏示意。读完带走的是「Service 要什么 / 仓储怎么存」的边界,不是可粘贴的内部包路径。事务怎么圈,见姊妹篇 /blog/go_transaction_boundary_patterns/。
估计阅读时间:8 分钟
目录
为什么现在要关心
短期直连驱动省事;中期痛点几乎总是:难测、查询散落、换存改爆。
业务层直接摸库时,现场通常长这样:
| 你看到的现象 | 常见真相 |
|---|---|
| 用例测试起 Mongo / Postgres 或大段 mock driver | Service 依赖了驱动类型,而不是「要什么数据」的接口 |
| 同一过滤条件复制进三个 Service | 索引与投影策略无法收口;改一处漏两处 |
| 「先加个 Redis」变成改半仓 | 缓存与主存没有统一出口,调用方全知道怎么查 |
| 事务散落在 repo 方法里各开各的 | 用例跨聚合时边界糊掉——账本不在一处 |
硬规则先钉三条(删掉比喻也能复述):
- Service 依赖仓储接口,不依赖驱动。 构造注入;单测换假实现。
- 方法名用用例语言(
FindActiveByUserAndPlatform),别把filter bson/ 裸 SQL 片段漏进 Service。 - 事务边界仍由用例定义。 仓储提供「能参与 tx」的能力;Unit of Work(工作单元)在 Service /
WithTx编排,不在仓储里偷偷散开账。细节见 /blog/go_transaction_boundary_patterns/。
心智模型:前台点单 vs 货架
主比喻:咖啡店。
- Service = 前台:懂「用户要续杯 / 注销会话 / 下单」,不懂货在第几层。
- Repository = 货架管理员:懂「货在哪、怎么取、怎么回写」。
- 驱动 / 集合 / 表 = 仓库货架布局——换货架不该逼前台改话术。
类比局限一句说清:前台 / 货架解释「职责分层与可替换」;解释不了「跨表事务谁开账、Outbox 放哪」——那是用例层的 Unit of Work,不是仓储命名能单独解决的。
精确定义:仓储挡的是什么
Repository(或等价的 DAL 接口) = 把 「怎么存」 挡在用例外面,让 Service 只依赖 「要什么」。
边界之内(仓储侧)通常负责:
- 针对某一聚合 / 实体的读写;
- 查询形状、索引友好的访问路径、必要的映射;
- 在外层传入的
tx/ 会话上执行,而不是自己偷偷另开散落事务(除非是明确的单方法本地写,且合同写清)。
边界之外(Service / 用例侧)通常负责:
- 业务规则与编排;
- 跨多个仓储的一致性(同库
WithTx,跨服务则短事务 + 补偿 / Outbox); - 对外副作用:发消息、调 RPC、写审计——默认不进仓储实现。
人话:仓储不是「第二个 Service」;权限、工作流、通知扇出塞进 DAO,边界会再次糊掉。
业界常见模式对照
教学基线是 B:接口 + 实现 + 构造注入;多实体同形态才谨慎碰 C;禁止 D。
| 模式 | 做法 | 代价 / 副作用 | 适用 |
|---|---|---|---|
| A. Service 直连 DB | handler → service → driver | 最快;难测、难换存、查询易散落 | 原型、一次性脚本 |
| B. Repository 接口 + 实现 | service → iface → mongo/sql 实现 | 多一层类型与装配 | 默认生产 |
| C. 泛型 BaseRepository | CRUD 公共方法 + 专用查询 | 抽象过度:专用查询仍往基类塞,接口变胖 | 多实体同形态、CRUD 真重复时 |
| D. 厚 DAO 含业务 | 「仓储」里写权限 / 工作流 / 发消息 | 边界再次糊掉;单测又变集成测 | 避免 |
选 B 的副作用要写清楚:多文件、多接口、DI(依赖注入)装配多一步——换来的是可假实现测试与换存时改动面收口。不是「最佳实践」空喊,是用抽象税买测试与演进空间。
教学示意:接口语言与假仓储
方法名说领域问题;单测用假仓储,不启动真库。
教学伪接口(示意,非某项目契约):
SessionRepository:
FindBySessionID(ctx, id) -> Session?
FindActiveByUserAndPlatform(ctx, userID, platform) -> Session?
Save(ctx, session) -> error
SessionService.Touch(ctx, userID, platform):
sess <- repo.FindActiveByUserAndPlatform(...)
// 业务规则… 再 Save对照坏味道:若接口是 Query(rawFilter any),查询语言已经漏进 Service——仓储形同虚设。
可测性一句话:假仓储返回固定会话;断言 Service 行为;少量仓储集成测只锁索引与真实查询形状。
常见坑
-
接口方法仍是
Query(rawFilter)/ 裸 SQL 字符串。
漏查询语言 = 没分层,只是多了一层函数转发。 -
每个 Service 挂一个「大而全」God Repository。
几十个方法的上帝仓储,和直连 DB 一样难测;按聚合拆,宁可接口窄。 -
在 Repository 里发消息、调 RPC、做权限判定。
副作用与策略进了「怎么存」层,换存或复用仓储时行为绑死。 -
重构只搬家,不补接口测试。
边界画在图上了,安全网没有——下次改实现仍不敢动。 -
仓储方法里各开各的事务。
用例要跨两个聚合时,散落Begin对不上账。编排留在用例 /WithTx,见 /blog/go_transaction_boundary_patterns/。 -
为「优雅」上 C,却把专用查询全塞进泛型基类。
抽象税交了,胖基类病没治——专用查询仍应落在具体仓储。
选型结论
- 新领域对象默认 B:仓储接口 + 驱动实现 + 构造注入。
- 方法名用领域问题,不用存储动词堆砌或原始 filter。
- 单测优先假仓储;少量仓储集成测锁索引与真实查询。
- 事务与 Outbox 留在用例层;仓储只参与,不偷偷散开账 → /blog/go_transaction_boundary_patterns/。
- 与具体表名 / 集合名无关——外人应能复述「接口挡驱动、用例定事务」即可。
下一步:挑一个直连 DB 最痛的用例,抽窄接口 + 假仓储单测;再决定要不要为重复 CRUD 引入有限的 C。别一上来全仓 God Repository。
TECH-CHECK / 润色自检
- [TECH-CHECK] 无。硬规则与模式 A~D 均为教学归纳;未声称某框架「官方内部必须这样」。
- Checklist「润色」:业界向、Hello 开篇、BLUF、少代码、三图
<Diagram>、无重复 H1、事务姊妹链尾斜杠、代价已写(B 的抽象税 / C 过度抽象 / D 禁止)。未建content/blog/*.mdx(按需求仅输出 polished draft)。