基础篇
进阶篇
高频篇
精选篇
手写篇
面经篇
AI 篇
原理篇
每日一题
小程序题库
  • 知识卡片碎片时间过考点
  • 场景篇按分类整理的大前端场景考点
  • 历年面经按年份追踪真实考点
  • 算法题库NEW在线编码即时判题
  • 专项自测100 题快速查漏
  • 前端基础
    • HTTP从报文一路讲到 HTTPS
    • 浏览器渲染、事件循环、进程
    • 计算机基础Linux、网络、操作系统
  • 进阶专项
    • 设计模式23 种模式怎么用
    • 前端系统进阶学习大型项目工程化
    • 前端综合文章长期沉淀的实践文
  • 工程与工具
    • Node学习指南从环境搭建到服务端
    • NPM工作流script、依赖与发布
    • Docker容器化部署上手
    • Canvas图形与动画实战
  • 路线与导图
    • 思维导图知识点全景图
    • 学习路线按图索骥不跑偏
  • 动态
    • 公众号动态公众号历史文章
    • 博客动态站长的技术博客
    • 开发者导航常用工具与文档站
    • AI 热点每日 AI 资讯与动向
AI 工作台
旧版
AIHT
内容
精选全部 AI 动态热点榜AI 日报收藏
分类
模型行业编程产品技术观点开源
更多
Agent 接入
返回首页开发者导航
AIHT
精选 / 资讯详情
8.0
热点
AI SCORE
技术实践2026-11-22 10:56

AI 生成任务如何用 PostgreSQL 原子结算

dev.to · AI#异步计费#原子结算#积分账本
Editor brief · 编辑速览

BabySea 用 Stripe 处理真实资金流转,用 PostgreSQL 维护内部积分账本,在异步生成开始时预留积分,任务结束后结算。方案考虑了回调延迟、重复投递和中途崩溃,并将可复用部分开源为 ledger-fortress。

文章思维导图
Knowledge map
拖拽缩放
AI deep read

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 和模拟重复回调,检查余额以及流水条数。额度包启用了异步支付时,也要验证不同事件指向同一笔已完成付款时只发放一次。
  • 给异步任务补四条结算用例,覆盖成功后恢复任务尝试退款、超时退款后成功、重新扣款时余额不足,以及恢复任务与回调同时执行。最后核对三样东西,余额、流水和前端是否开放结果。
Original source

本文由 AI 通读原文后重新编写,观点部分为站内判断,细节以原文为准,来源 dev.to · AI,原文版权归原作者所有。

阅读原文
上一篇
用编程 Agent 先审计依赖再迁移
下一篇
用 Spring AI 串联四步数据处理

资讯速览

dev.to · AI · 2026-11-22 10:56

AI 评分 8.0 / 10

相关标签

#异步计费#原子结算#积分账本

继续阅读

  • 修复遗漏同类代码,占项目缺陷近四分之一
  • 用编程 Agent 先审计依赖再迁移
  • 用 Spring AI 串联四步数据处理
  • 多模型路由如何在调用前确定执行顺序
  • 接入多个生成模型时如何处理审核字段差异