跳到正文
D8-05账务域1 分钟更新于 2026-11

记账入口

一句话

记账只能有一个入口,多个入口必然不平。

本文目录8 节

记账入口

它解决什么

记账只能有一个入口:所有资金动作都调同一个 post 接口,才能保证分录格式、幂等键、借贷校验一致。多个入口(各业务模块直连数据库写分录)必然不平,因为每个入口的校验强度不同,A 模块校验了科目,B 模块没有。

怎么用

  • 唯一入口
  • 统一校验
  • 批量提交

一个判断

三个业务模块各自写分录,月结时借贷差 3 万,查了两周。

边界

单一入口的边界是性能:高频场景要支持批量提交,但批量内部仍要保证原子性与幂等,不能为了吞吐牺牲一致性。

一个反例

某公司三个业务模块各自写分录,月结借贷差 3 万,查了两周才发现校验强度不同。现在记账只有唯一入口,统一校验。入口不唯一,校验强度就一定会出现差异。这类问题在上线时看不出来,出故障时才致命。

常见误判

  • 各业务模块直连数据库写分录。

自查清单

  • 知道这个模块的边界在哪
  • 知道它的状态机有哪几个状态
  • 知道它出错时的兜底路径
  • 知道它的数据存在哪张表

依据

  • 记账接口的唯一入口原则。

相关:记账接口设计

相关阅读