AI 生成任务如何用 PostgreSQL 原子结算
BabySea 用 Stripe 处理真实资金流转,用 PostgreSQL 维护内部积分账本,在异步生成开始时预留积分,任务结束后结算。方案考虑了回调延迟、重复投递和中途崩溃,并将可复用部分开源为 ledger-fortress。
AI 深度解读
用户在 Stripe 付完钱,AI 视频的账才刚开始算。任务发出去前要预留额度,几分钟后可能成功、失败或超时,回调还可能重复、迟到。最棘手的是,系统刚按超时退回额度,供应商又发来了成功结果,这笔账该怎么算?
BabySea 把真实资金交给 Stripe,把可用额度和结算记录交给 PostgreSQL。应用负责调度,数据库负责守住余额和状态。做过异步任务的前端和全栈开发者,可以从这套设计里拿走预扣、回调重试和崩溃补偿的具体做法,也能看清它依赖哪些定价和业务前提。
同时来了两笔生成请求,谁能花掉最后一份额度?
BabySea 在接收任务时先用 priceGeneration(input) 算出价格,把这个金额和 generationId 一起传给 fortress.reserve。预扣成功才调用 runGeneration(),余额不足就返回 insufficient_credits。这适合提交时就能定价的产品,例如根据 model: 'video-5s'、durationSeconds: 5、resolution: '720p' 算出本次费用。输出数量、音频模式也可以参与定价,后续确认和退款都沿用已经接受的金额。
下面这条 SQL 把余额判断和扣减放进同一次数据库更新。
UPDATE credits
SET credits = credits - p_credits,
updated_at = now()
WHERE account_id = p_account_id
AND credits >= p_credits
RETURNING credits;
关键是 AND credits >= p_credits。两笔请求同时更新同一账户时,后执行的更新会根据更新后的余额重新判断,余额不够就更新零行。应用省掉了先查余额再扣款的时间差,也无需为这一步另加分布式锁。
credits 表保存可用余额,credit_ledger 保存变动记录,余额和变动金额都使用 numeric(10, 3)。数据库约束要求余额至少为 0、流水金额大于 0。reserve_credits 扣余额并记一条预扣流水,完整的原子性还依赖这两步一起提交。成功时 charge_credits 通常只补一条确认记录,因为预扣已经发生。失败或取消时,refund_credits 把额度退回去。
同一条回调重发,和两条回调乱序,是两回事
重发考验幂等性,也就是同一个业务动作重试多次,结果只生效一次。作者用部分唯一索引约束各类流水,下面这段定义了数据库用哪些字段识别重复操作。
CREATE UNIQUE INDEX idx_credit_ledger_charge_idempotent
ON credit_ledger (generation_id) WHERE type = 'charge';
CREATE UNIQUE INDEX idx_credit_ledger_refund_idempotent
ON credit_ledger (generation_id) WHERE type = 'refund';
CREATE UNIQUE INDEX idx_credit_ledger_add_idempotent
ON credit_ledger (account_id, description) WHERE type = 'add';
CREATE UNIQUE INDEX idx_credit_ledger_reserve_idempotent
ON credit_ledger (generation_id)
WHERE type = 'reserve' AND generation_id IS NOT NULL;
最后一行限定了预扣去重的范围,只有带 generation_id 的预扣才受这个索引保护。发放额度走另一套键,add 按 (account_id, description) 去重。索引会拒绝重复流水,结算函数还得处理冲突,确保重试时余额也只变动一次。
乱序更麻烦。同一个任务的 charge 和 refund 各自只有一条,仍可能一前一后都到达。若成功已确认,随后到来的退款会返回 FALSE。若超时已经退款,迟到的成功回调会触发 charge_credits 在锁内检查退款记录,先重新扣回额度,再记录成功。此时用户可能已花掉退回的额度,余额不足就返回 FALSE,留给应用重试、暂停账户或升级处理。
进程崩溃则可能让预扣一直挂着。作者用 SELECT * FROM find_orphaned_reservations(5, 100); 查找超过安全窗口、又没有确认或退款记录的预扣,再由恢复任务调用同一个 refund_credits。原文给了调用参数 5 和 100,没有交代 5 的时间单位。恢复任务赶上回调也走同一套结算规则,重复运行时已结算的任务会被跳过。
Stripe 收到钱以后,应用怎么把它变成额度?
Webhook 入口用 request.text() 读取原始请求体,取 stripe-signature 请求头,再用 STRIPE_WEBHOOK_SECRET 验签。签名依赖 Stripe 发来的原始字节,先解析 JSON 再序列化可能改变这些字节。
订阅走 invoice.paid,一次性额度包走 checkout.session.completed 或 checkout.session.async_payment_succeeded,处理的是已付款的额度包。默认按美分除以 100 换算额度,订阅示例用 invoice.amount_paid / 100,用 invoice:${invoice.id} 作为发放键。BabySea 生产环境按内部订单 ID 给额度包去重,开源辅助函数则用 order:${paymentIntentId ?? session.id}。续费采用累加,原余额 3.500 收到 29.000 额度后变成 32.500,一次性购买的余额因此可以结转。
作者还提到,用户打开 Checkout 后可能先失去订阅资格,再完成购买。团队在 webhook 到达时重新调用 hasActiveSubscription(accountId),资格失效就记录 skipped_no_subscription。至于已经收的钱如何处理,原文没有给出后续流程。charge.refunded 和 charge.dispute.created 同样留给独立业务流程,因为对应的额度可能早已用完。
账本表启用行级安全,撤销 anon 和 authenticated 的表访问权限,写入通过设置了 search_path = pg_catalog, public 的 SECURITY DEFINER 函数执行。低余额提醒用 void fortress.checkAlerts(accountId) 在结算路径之外触发,每次跌破阈值只提醒一次,余额恢复后重置。开源项目 ledger-fortress 采用 Apache 2.0,提供 PostgreSQL 迁移、TypeScript SDK、核心 Python SDK、Stripe webhook 辅助函数、JSON Schemas 和本地示例。
我的判断
用同一个 PostgreSQL 管余额和流水,适合已经用它存账户数据、提交时能确定价格的团队。相比在 Node 进程里先读余额再扣款,条件更新直接解决了并发请求争抢余额的问题。队列也能按账户串行处理任务,但 Stripe 重试和崩溃恢复仍可能从其他入口进来,结算规则集中在数据库会更容易核对。原文描述的是作者团队的生产经验,没有给吞吐、延迟或故障率数据,也没有展示完整的事务和锁实现。可以借鉴它定义的业务规则,性能和并发行为还得结合自己的实现验证。
最大的前提是预扣金额可以直接作为最终金额。若产品按实际生成时长或最终用量收费,预估和实付就可能不同。当前开源包没有 settle_credits、差额调整流水、负余额或坏账跟踪,Stripe 退款和争议也没有自动扣回额度的 clawback_credits。另一个需要产品定规则的地方是结果交付。迟到的成功回调如果补扣失败,原文把后续处理交给应用,用户此时能否查看或下载结果,要和这条失败分支一起设计。
能拿来做什么
- 给 Node 生成接口分配稳定的
generationId,提交时把接受价格和任务绑定。预扣失败就返回insufficient_credits,前端可以据此提示余额不足。 - 用同一笔 Stripe 付款分别重放 webhook 和模拟重复回调,检查余额以及流水条数。额度包启用了异步支付时,也要验证不同事件指向同一笔已完成付款时只发放一次。
- 给异步任务补四条结算用例,覆盖成功后恢复任务尝试退款、超时退款后成功、重新扣款时余额不足,以及恢复任务与回调同时执行。最后核对三样东西,余额、流水和前端是否开放结果。