防止重复成绩需要发送方和接收方共同约定业务记录标识及幂等规则。网络超时不一定意味着服务端未保存结果,不能直接生成新记录反复重发。应先能查询或识别原提交状态,再按约定重试,并对相同编号但内容不同的请求给出明确处理结果。
理解超时后的不确定状态
请求发送后可能已被接收方保存,只是响应未成功返回。此时发送方显示超时,而接收方已经有成绩。如果每次重试都创建一个新编号,同一次训练就可能被统计多次,因此需要跨重试保持业务身份不变。
HTTP规范说明,幂等操作的多次相同请求具有与单次请求相同的预期效果;不能因为使用了接口就默认具备这种性质。成绩新增若采用POST等请求,是否可安全重试必须由应用层设计和双方约定来保证。
约定去重与冲突处理
可把一次作答的记录编号作为业务去重依据,由接收方在保存时核验。相同编号与相同内容重复到达时,应返回可确认的原结果;相同编号内容不同则应区分正式更正与异常冲突,不能静默覆盖。
发送方保存提交状态、尝试记录和接收方确认信息,重试频率及最大次数按服务条件配置。达到重试边界后转入待处理队列,让管理者查看原因并按权限补传,避免后台无限请求或教师重复点击造成混乱。
在验收中验证网络边界
测试连续重复提交、响应丢失后重发、接收方暂不可用以及成绩修订等情形,观察是否只保留约定数量的有效记录。应同时核对数据库或业务列表及汇总结果,确保界面去重没有掩盖底层重复。
补传结束后用记录编号核对发送与接收状态,保留已解决与未解决清单。若无法判断是否保存,应由指定人员核查后处理,不应让学生重新完成同一次考试来弥补接口状态不明确的问题。
实施检查清单
- 同一次作答重试使用稳定业务编号。
- 重复内容与冲突内容有不同处理规则。
- 重试失败后有可查看的待处理状态。
- 重复请求和响应丢失场景经过核验。
常见问题
请求超时能否直接认为提交失败?
不能。服务端可能已保存结果,应通过原记录编号查询或按约定的幂等机制重试。
关闭提交按钮是否足以防止重复?
不足以。按钮限制只能减少用户重复点击,网络重试和服务间重复请求仍需接收端按业务记录处理。