假设你在手机上填写一张报修单。点“提交”,等了十几秒,页面提示网络超时。内容还在,于是又点了一次。等网络好转,列表里出现了两张内容完全相同的工单。
从用户的角度看,第二次点击是在补救失败。从服务端的角度看,它可能接到了两次创建请求。
这类问题很容易被归结为“用户点得太快”。可如果第一次提交已经成功,只是成功消息没回来,哪怕用户隔一分钟再点,也可能重复创建。
超时以后,结果可能还没查清
一次提交至少要经历请求发送、服务端处理、结果返回。客户端没等到结果,无法仅凭这一点知道服务端执行到了哪里。
请求可能根本没到,也可能正在处理,还可能已经写入数据库,只差最后的响应没有被客户端收到。界面把这些情况统一写成“提交失败”,就会给用户一个错误暗示:再提交一次应该没问题。

图 1|示意流程。客户端超时与服务端是否已创建记录,是两个需要分别确认的事实。
对于创建工单、发布评论、提交报名这类操作,更准确的状态往往是:暂时无法确认提交结果。
它不适合一直转圈,也不适合直接宣布失败。可以保留填写内容,提供“查询提交结果”,并让后续重试仍然指向原来的那次提交意图。
按钮置灰,只能挡住眼前的重复点击
点击后禁用按钮当然有用,但它只覆盖当前页面里的一小段时间。
用户退出页面重新进入,按钮可能恢复了;应用进程重建,内存里的“正在提交”也可能丢了;网络组件自己重试,甚至不需要第二次点击。服务端不能把“按钮已经置灰”当成防重保证。
需要先约定一个业务身份:用户这次想创建的工单到底是哪一张。
例如,客户端在首次提交前生成一个提交标识,并把它与草稿一起保存。同一意图的查询和重试沿用这个标识。用户明确新建另一张工单时,才分配新标识。具体放在请求头还是请求体里,由接口约定决定;写上一个名叫“幂等键”的字段,本身不会让接口变得幂等。
HTTP 规范也没有把任意失败的 POST 都当作可自动重试的操作:需要有依据确认其实际语义允许安全重复,或确认原请求尚未执行。
服务端要让同一用户、同一种操作、同一个提交标识得到一致处理。已完成的返回已有结果,处理中返回明确状态;同一标识携带不同内容时,应拒绝冲突,不能悄悄创建另一条记录。
这里还有一个容易遗漏的实现细节:先查“有没有”,再单独插入,并不能挡住两个同时到达的请求。去重记录和业务写入要通过合适的唯一约束、事务或等效机制协调。若后面还会发通知、写消息队列,也要检查这些副作用会不会重复发生。
把“等不到回执”变成能反复检查的用例
正常网络下,提交很快结束,结果不明的时间窗口不容易出现。可以先把响应方向调慢,观察界面怎么处理等待。
这里用我自己开发的 Android 工具「弱网管家」演示配置。先选中被测应用,再准备独立模板,避免把其他应用的流量也混进这一轮。

图 2|Pixel 6 实机截图,弱网管家 1.0.2。截图展示配置入口,尚未选择目标应用,也未启动本工具的测试。
第一轮保留原始网络作为对照;第二轮只增加下行延迟,例如填写 1000 ms,上行延迟、抖动和随机丢包先保持 0。目的是拉长等待,不是宣称这个数字能还原某座地铁站。

图 3|2026-10-19 在 Pixel 6 上临时填写的配置:上行延迟 0、下行延迟 1000 ms。配置值不是接口耗时,也不保证必然触发超时。
网络工具不知道工单何时落库,也不能精准地只丢掉某一条 HTTP 成功回执。要稳定覆盖“已创建但客户端超时”,更可靠的办法是配合受控测试服务:记录业务写入完成时刻,再延后响应,使它超过客户端配置的等待期限。
随后用真实网络损伤补充交互检查。随机丢包和延迟作用于网络传输,不能把“丢了一个包”直接等同于“整个业务响应丢失”。
查数据库,比看一次成功提示更有说服力
测试前准备一份可辨认的内容,例如带有测试编号的报修描述,并记录提交标识。不要用标题相同就判定重复,因为用户也可能有意提交两张相同内容的工单。
建议把下面几种操作分别跑完:
| 操作 | 要确认的结果 |
|---|---|
| 等待过程中再次点击 | 同一意图不会创建第二条记录 |
| 超时后点重试 | 沿用原提交标识,返回原结果或明确的处理中状态 |
| 离开页面再回来 | 未确认的提交能继续查询,不会自动变成全新提交 |
| 同一标识、不同内容 | 返回冲突,原记录不被无声覆盖 |
| 用户明确新建第二张 | 使用新标识,可以正常创建 |
核对时把客户端日志、服务端处理日志和最终业务记录串起来。至少要能回答:发了几次请求,分别用了什么标识,最终产生了几个业务对象。
列表里暂时只有一条,不一定足够。列表可能有缓存、分页或延迟同步。验收应检查服务端的权威结果,并确认关联通知等副作用没有重复。
提交标识也需要约定有效期。过期后服务端是否仍能找到原结果,客户端还能不能用旧标识重试,都要明确。否则“隔一小时再试”可能绕过原先的去重范围。
提示语也要承认结果尚未确认
当服务端明确拒绝创建时,可以告诉用户失败原因;当只是没有收到回执时,更合适的提示是“暂时无法确认提交结果,请查询后再操作”。
这个改动不只是文案调整。它要求页面保留查询入口、保存提交身份,并让查询得到的结果与原草稿对应。否则用户还是只能靠再点一次来猜。
如果要给这条用例写一句验收标准,可以写得很具体:同一提交意图经历超时、重试和页面重进后,最终只产生一份业务结果;用户主动发起的新提交仍然正常生效。
网络可以让回执迟到,但“迟到以后怎么办”,应该由业务流程说清楚。
博客深入剖析网络超时导致重复提交的根本原因,指出客户端提示‘失败’不等于服务端未执行,并强调需通过唯一提交标识、服务端幂等控制、事务级去重及状态可查询机制来保障创建操作的幂等性。内容涵盖Android弱网测试实践、HTTP语义约束、数据库验证方法及用户提示文案优化,聚焦分布式系统中高可靠业务操作的设计要点。
307

被折叠的 条评论
为什么被折叠?



