Service 别直接摸库:Repository 边界怎么画

Service 别直接摸库:Repository 边界怎么画

Hello,我是小兔大白糖。 业务 Service 里直接 collection.Find / db.Query,第一周写得飞快;第二个月单测要么起真库,要么 mock 半个驱动;换存储或加一层缓存时,用例文件跟着炸。写成这篇,给要做 应用服务与持久化边界 调研的初中级后端同学:不是某仓库的搬家工单,而是业界可复述的 Repository(仓储)心智模型。

说明:下文接口名、伪流程均为教学脱敏示意。读完带走的是「Service 要什么 / 仓储怎么存」的边界,不是可粘贴的内部包路径。事务怎么圈,见姊妹篇 /blog/go_transaction_boundary_patterns/。

估计阅读时间:8 分钟


目录


为什么现在要关心

短期直连驱动省事;中期痛点几乎总是:难测、查询散落、换存改爆。

业务层直接摸库时,现场通常长这样:

你看到的现象常见真相
用例测试起 Mongo / Postgres 或大段 mock driverService 依赖了驱动类型,而不是「要什么数据」的接口
同一过滤条件复制进三个 Service索引与投影策略无法收口;改一处漏两处
「先加个 Redis」变成改半仓缓存与主存没有统一出口,调用方全知道怎么查
事务散落在 repo 方法里各开各的用例跨聚合时边界糊掉——账本不在一处

硬规则先钉三条(删掉比喻也能复述):

  1. Service 依赖仓储接口,不依赖驱动。 构造注入;单测换假实现。
  2. 方法名用用例语言(FindActiveByUserAndPlatform),别把 filter bson / 裸 SQL 片段漏进 Service。
  3. 事务边界仍由用例定义。 仓储提供「能参与 tx」的能力;Unit of Work(工作单元)在 Service / WithTx 编排,不在仓储里偷偷散开账。细节见 /blog/go_transaction_boundary_patterns/。
对照:Service 直连 DB vs Service 依赖 Repository 接口再落到 DB 实现
对照:Service 直连 DB vs Service 依赖 Repository 接口再落到 DB 实现 · 点击查看 SVG 原图

心智模型:前台点单 vs 货架

主比喻:咖啡店。

  • Service = 前台:懂「用户要续杯 / 注销会话 / 下单」,不懂货在第几层。
  • Repository = 货架管理员:懂「货在哪、怎么取、怎么回写」。
  • 驱动 / 集合 / 表 = 仓库货架布局——换货架不该逼前台改话术。
前台点单与货架管理员:Service 说要什么,Repository 管怎么取
前台点单与货架管理员:Service 说要什么,Repository 管怎么取 · 点击查看 SVG 原图

类比局限一句说清:前台 / 货架解释「职责分层与可替换」;解释不了「跨表事务谁开账、Outbox 放哪」——那是用例层的 Unit of Work,不是仓储命名能单独解决的。


精确定义:仓储挡的是什么

Repository(或等价的 DAL 接口) = 把 「怎么存」 挡在用例外面,让 Service 只依赖 「要什么」。

边界之内(仓储侧)通常负责:

  • 针对某一聚合 / 实体的读写;
  • 查询形状、索引友好的访问路径、必要的映射;
  • 在外层传入的 tx / 会话上执行,而不是自己偷偷另开散落事务(除非是明确的单方法本地写,且合同写清)。

边界之外(Service / 用例侧)通常负责:

  • 业务规则与编排;
  • 跨多个仓储的一致性(同库 WithTx,跨服务则短事务 + 补偿 / Outbox);
  • 对外副作用:发消息、调 RPC、写审计——默认不进仓储实现。

人话:仓储不是「第二个 Service」;权限、工作流、通知扇出塞进 DAO,边界会再次糊掉。


业界常见模式对照

教学基线是 B:接口 + 实现 + 构造注入;多实体同形态才谨慎碰 C;禁止 D。

模式做法代价 / 副作用适用
A. Service 直连 DBhandler → service → driver最快;难测、难换存、查询易散落原型、一次性脚本
B. Repository 接口 + 实现service → iface → mongo/sql 实现多一层类型与装配默认生产
C. 泛型 BaseRepositoryCRUD 公共方法 + 专用查询抽象过度:专用查询仍往基类塞,接口变胖多实体同形态、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 行为;少量仓储集成测只锁索引与真实查询形状。

单测用 fake Repository 替换真实实现,无需启动数据库
单测用 fake Repository 替换真实实现,无需启动数据库 · 点击查看 SVG 原图

常见坑

  1. 接口方法仍是 Query(rawFilter) / 裸 SQL 字符串。
    漏查询语言 = 没分层,只是多了一层函数转发。

  2. 每个 Service 挂一个「大而全」God Repository。
    几十个方法的上帝仓储,和直连 DB 一样难测;按聚合拆,宁可接口窄。

  3. 在 Repository 里发消息、调 RPC、做权限判定。
    副作用与策略进了「怎么存」层,换存或复用仓储时行为绑死。

  4. 重构只搬家,不补接口测试。
    边界画在图上了,安全网没有——下次改实现仍不敢动。

  5. 仓储方法里各开各的事务。
    用例要跨两个聚合时,散落 Begin 对不上账。编排留在用例 / WithTx,见 /blog/go_transaction_boundary_patterns/。

  6. 为「优雅」上 C,却把专用查询全塞进泛型基类。
    抽象税交了,胖基类病没治——专用查询仍应落在具体仓储。


选型结论

  1. 新领域对象默认 B:仓储接口 + 驱动实现 + 构造注入。
  2. 方法名用领域问题,不用存储动词堆砌或原始 filter。
  3. 单测优先假仓储;少量仓储集成测锁索引与真实查询。
  4. 事务与 Outbox 留在用例层;仓储只参与,不偷偷散开账 → /blog/go_transaction_boundary_patterns/。
  5. 与具体表名 / 集合名无关——外人应能复述「接口挡驱动、用例定事务」即可。

下一步:挑一个直连 DB 最痛的用例,抽窄接口 + 假仓储单测;再决定要不要为重复 CRUD 引入有限的 C。别一上来全仓 God Repository。


TECH-CHECK / 润色自检

  • [TECH-CHECK] 无。硬规则与模式 A~D 均为教学归纳;未声称某框架「官方内部必须这样」。
  • Checklist「润色」:业界向、Hello 开篇、BLUF、少代码、三图 <Diagram>、无重复 H1、事务姊妹链尾斜杠、代价已写(B 的抽象税 / C 过度抽象 / D 禁止)。未建 content/blog/*.mdx(按需求仅输出 polished draft)。