用户没等到回执又发了一遍,AI智能体就多扣了一次款,2026年加个确认弹窗到底能不能挡住?
结论先说:AI智能体里的重复扣款、重复建单,根因多数不在模型答错,而在带写副作用的工具调用缺少幂等约束。管用的拦截要落在业务层的幂等键、会话状态锁与结果回放三处;加确认弹窗、按钮置灰只能挡住手动连点,挡不住客户端超时重试、流式断连重发和多端并发。判断标准很直接:同一个幂等键并发触发十次,业务侧只应落一条记录。
为什么AI智能体里的重复执行,比普通表单更难拦
普通表单的提交路径是确定的:一次点击对应一个请求,前端拦一道、后端唯一索引拦一道,基本够用。智能体不一样,一次对话里模型可能连续发起多次工具调用,遇到超时还可能自己重试。按 2026 年常见做法,主流模型族的 function calling 接口大多只保证单次调用返回,「这一次是不是已经执行过」并不由模型负责,要由调用方自己兜住。
更麻烦的是输入本身是流式的。网络抖一下、SSE 断连、用户没等到回执又发一遍,同一段意图会以不同文本重新进入编排层,模型看不出来这是「同一件事」。所以只要工具带副作用,建单、扣库存、扣额度、退款、发短信这些操作,「模型答得对」和「系统只执行一次」就是两件独立的事。
- 副作用工具天然不幂等:写进去就是一条新记录,重放一次就多一条。
- 重试不止一层:用户手点、客户端超时重发、网关重试、模型自主重试,四层会叠加。
- 状态不连续:断连重连后,前端可能拿不到上一次的请求标识。
重复一般从哪几个口子进来
先盘点重复的来源再选方案,通常比上来就加分布式锁省事。项目里漏的往往只有一两处,把全套高并发方案压上去,反而增加联调成本和故障面。
- 用户侧连点与重发:按钮没有加载态,或等待超过几秒,用户就再点一次、再发一遍。
- 客户端超时重试:移动网络切换时请求已到服务端,回执没回来,客户端按默认策略重发。
- 流式断连重连:前端自动重连后,把同一段用户消息再次投递。
- 模型自主重试:第一次工具调用超时,模型在同一轮里再调一次,参数几乎相同。
- 多端并发:小程序和 H5 同时开着,用户两边都点了确认。
判断口径可以写具体些:把上面五类来源逐一造用例,能稳定复现的那几条是这一期要堵的;复现不出来的先记录、不改造,避免为理论上才发生的场景增加复杂度。
四层防重框架:能力层、业务层、载体、数据与风控
之所以按四层拆,是因为它们负责的东西不一样:能力层定义模型和工具的契约,业务层决定「这件事做没做过」,载体层决定用户还能不能再点一次,数据与风控层负责事后发现漏网的。混在一起谈,常出现「前端加了 loading 就以为安全了」的误判。
- 能力层(模型与工具):给每个写操作工具补上幂等键入参,并约定超时后不自动重试写操作,重试只对读操作放开。模型只负责传键,不负责判断是否重复。
- 业务层(编排与状态):用「会话标识 + 意图标识 + 关键参数指纹」拼幂等键,写入去重表并配唯一索引;命中已有记录时走结果回放,把上次的执行结果直接返回给模型,让模型用自然语言说清「刚才已经处理过,结果如下」。
- 载体层(H5 / 小程序 / APP / 客服工作台):提交后立即置灰并给出明确进度,断连重连时带上一次请求标识,多端登录时对写操作加会话级标记。
- 数据与风控层:把每次工具调用的入参、幂等键、执行结果落库,配一条「同一幂等键多次执行」的告警;涉及资金的业务再挂一条与订单表、流水表的每日对账。
这里有个常见错误:幂等键算成了包含时间戳的哈希,每次重试指纹都不一样,去重表形同虚设。幂等键里不要放时间戳、随机数和完整的自然语言原文,只放能区分「是不是同一件事」的业务字段,比如商品、金额、收款方、券种。
结果回放和直接拒绝怎么选
两种都算合格,体验差别不小。直接拒绝会让用户以为没成功,往往导致第三次提交;结果回放把上次的单号、金额、时间原样返回,用户能对上,客服也好解释。涉及钱和单的业务,经验上优先做回放;只做拒绝的,至少要在文案里写清「已提交过,请勿重复操作」。
交付现场:只加了确认弹窗,活动期补了三天
常见情形是周期只剩两周,老订单接口由别的团队维护、短期加不了唯一索引,甲方又催着先上线。当时的做法是先加一个二次确认弹窗加三秒防抖,把幂等表排进下一期。上线后平时没问题,一到活动期,用户网络慢、没等到回执就连发两三次,同一笔订单建了三张,客服手工撤单,还牵扯库存回滚。
事后补幂等表和结果回放,连带联调与回归,经验区间大约 3 到 5 人日,比上线前一起做贵出不少。按我们的交付习惯,涉及下单、扣额度、发券这类写操作的智能体,幂等键和唯一索引通常跟业务表同期设计;约束实在摆不开时,至少要把「哪些工具带副作用」列成清单交甲方确认,这比口头说「我们会注意」能落地。
三种做法怎么选:置灰弹窗、幂等回放、分布式锁
这三种常被当成一回事,其实防的范围不同。前端置灰与确认弹窗防的是用户手动连点,业务层幂等防的是重复请求,分布式锁防的是同一时刻的并发写入;只做一层,别的口子照样漏。成本按项目经验给区间,随接口归属和改造范围浮动。
- 前端置灰 + 防抖 + 确认弹窗:改动在载体层;覆盖手动连点,覆盖不了超时重试和多端并发;经验成本约 0.5 到 1 人日;是成本较低的第一道。
- 业务层幂等键 + 结果回放:改动在业务层和数据库;覆盖重试、重连、多端并发;经验成本约 3 到 8 人日,取决于要不要动老接口;下单类智能体的基本配置。
- 分布式锁:改动在服务端并发控制;覆盖同一瞬间的并发写;经验成本约 2 到 5 人日,另加运维复杂度;适合高并发抢购,普通对话式下单一般不必上。
判断口径可以更硬一点:如果业务能容忍「偶尔出现极少量重复单、靠客服撤单兜底」,前端置灰加一层去重表就够;如果重复直接对应资金损失或库存错乱,幂等键和唯一索引不能省。
适用与不适用边界
适合做的:智能体触发的写操作,如建单、支付确认、发券、扣额度、发短信与推送、改地址、退改签。这类操作重复执行一次就是一次真实成本,花几个人日做幂等是划算的。
不必上全套的:纯问答、只读查询、知识库检索、内部演示型智能体。这些没有副作用,重复调用顶多多花一点 token,前端防抖加超时提示就够。边界可以这样表述:工具只要不带写副作用,就不必设计幂等键;一旦带上写副作用,无论调用频率多低,都要有去重兜底。
- 多轮对话里用户改了收款账户再确认,属于正常的新意图,幂等键要随之变化,不能误判成重复。
- 私有化部署、模型自建的环境,去重表建议跟业务库同库同事务,跨库会留下时间窗口。
- 接第三方接口时对方若不支持幂等,只能在外层建表加结果回放,并把这项风险写进验收说明。
常见问题
智能体重复执行,能不能靠提示词让模型别调两次?
很难。提示词只能降低概率,主流模型族的工具调用不保证跨请求去重,稳定性仍要靠在业务层用幂等键兜底。
幂等键只用一个会话ID够不够?
通常不够。同一会话里用户可能确实想下两单,幂等键要带上意图和关键参数指纹,只用会话ID容易误杀正常复购。
老订单接口不支持幂等,改造一般要多久?
看接口归属。自家接口加唯一索引常见经验区间 3 到 8 人日;第三方接口只能在外层建去重表加结果回放,约 2 到 5 人日。
怎么验收防重到底做没做到位?
按「同一幂等键并发十次只落一条」「断连重连不重复执行」「多端同时提交只成功一次」三条造用例,跑通即算合格。
下一步建议:先把智能体的工具清单过一遍,标出所有带写副作用的接口,再按「幂等键 + 唯一索引 + 结果回放」补齐,用同一幂等键并发十次的用例验收。若是纯问答或只读检索类智能体,加前端防抖与超时提示即可,不必为此投入分布式锁与对账体系。
-
客户年初按旧价预充了一整年的API额度,上游中途调价,2026年这笔账该按充值日算还是按调用日算?
日期:2026年11月16日 阅读:22
-
孩子照AI讲的几何步骤写作业被老师扣分,2026年换个大模型就能补回来吗?
日期:2026年11月15日 阅读:48
-
给公司两百人做AI形象照,出片后同事说认不出谁是谁,2026年这批图该按哪张底图来验收?
日期:2026年11月14日 阅读:108
-
顾客在豆包、Kimi里问「敏感肌面霜推荐」,翻了几屏都是别家,2026年只改商品页文案还能被AI答案提到吗?
日期:2026年11月13日 阅读:62
-
编辑退回稿子说参考文献有三条查不到,作者还说是AI照着原文引的,2026年先别急着换模型,该翻哪几样记录?
日期:2026年11月12日 阅读:131




