Skip to content

1398281322-a11y/java-backend-guardrails / skills/java-backend-guardrails/reconciliation

reconciliation

Verified

对账 / 差错

When to Invoke

支付、退款、分佣、核销、券、库存跨系统;事务消息/最终一致上线后。高级面试常追问「不一致了怎么办」——答案是对账,不是再上 2PC。

When NOT

单表本地事务且无外部资金。不要用对账替代唯一键和幂等。

风险(面试考点)

最终一致系统 一定会 短暂不一致。没有对账 = 线上默默错账。对账要有:数据源、粒度、窗口、差错单、人工/自动平账、幂等。

两边都成功、一边成功、金额不等、重复入账、漏单,分类不同,处理不同。

方案选型(轻量优先)

通道对账双方默认节奏
支付本地支付单 vs 渠道对账单T+1 文件 + 当日准实时抽查
分佣订单已支付 vs 分佣流水日批 + 关键单实时
库存Redis 预扣 vs DB定时对齐,以 DB 为准
核销券状态 vs 订单核销记录日批

默认方案

  1. 每笔资金有 唯一流水号(与 idempotent 同一键)。
  2. 对账任务按日:拉渠道文件,按流水号 full outer join。
  3. 差错写入 t_recon_diff,状态 NEW/HANDLED,处理动作幂等。
  4. 自动平:漏单补记账;重复跳过;金额不等告警人工。
UNIQUE KEY uk_recon (biz_date, channel, trade_no)

禁止对账程序直接 UPDATE 余额两遍。只插「补账流水」,再走原来的入账逻辑。

反例

错误:有 Seata 就不用对账。 正确:AT/TCC 仍会悬挂、空回滚,资金必须对账。

错误:对账发现少了一笔就再调一次支付接口。 正确:查单,按本地状态机补,不新开支付。

验证

  • 故意丢掉一条 MQ,日对账能检出并补平一次。
  • 重复补账不增加金额。
  • 渠道文件晚到有重跑,不重复处理已 HANDLED。

评审清单

  • 有流水号和对账表
  • 平账走原入账幂等逻辑
  • 未用「上分布式事务」代替对账

slack-gif-creatoranthropics/skillsKnowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack."Stars: 197kUpdated Claude CodeCodexVerifiedInstall
ponytailDietrichGebert/ponytailLazy senior dev mode for any coding task: the smallest change that fully solves it, and a reply a busy human understands in one read.Stars: 194kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report.Stars: 194kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailList every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt.Stars: 194kUpdated Claude CodeCodexVerifiedInstall