给一个社区活动做报名页,最容易漏掉的是点下提交之后的几秒。网慢时,页面看起来没有动静,有人会再点一次,也有人直接刷新。服务端可能早就登记成功,只是确认消息还没回来。这样一来,报名列表里就可能多出一条记录,用户也不知道该以哪一条为准。处理这个问题,可以先看页面如何接住第二次操作,再看接口收到第二份请求时怎么处理。
把提交收进同一个入口
让点击按钮、回车和程序触发的提交都经过表单的提交事件。对于自行发送请求的表单,在处理函数开头取消浏览器的默认提交,再检查当前是否有一次提交正在处理。通过检查后,要在首次异步操作之前立即设置提交标记,否则两次触发可能同时通过检查。界面的禁用状态可以跟着标记更新,实际拦截仍在提交处理函数里完成。程序主动提交时用 form.requestSubmit() ,让浏览器照常做表单校验并触发提交事件。直接调用 form.submit() 会跳过这两步。
按钮禁用后,在它附近的状态区域显示「正在提交」,让屏幕阅读器也能读到。请求使用本次提交时采集的数据,页面后续的编辑留给下一次操作。如果要禁用输入控件,先采集数据,因为浏览器通常会从表单数据里排除已禁用的字段。成功后显示报名结果和编号。遇到明确的字段错误,保留已填内容,让用户改完再提交。请求结束就清除正在提交的标记,再按结果展示成功、可编辑或待确认的界面。反馈尽量放在用户刚操作的位置,别让他在页面顶部和底部之间来回找。
用同一个幂等键处理重试
当浏览器等不到响应时,页面可以显示「暂未确认」,并保留本次请求的数据。接口支持幂等键时,前端为一次报名生成一个随机标识。超时后重试,带上原来的标识和原来的请求内容。这样即便第一次已经写入,第二次也能找到那条记录。遇到接口明确拒绝并要求修改字段的情况,修正后的提交再使用新键。如果结果还未确认,先查询原报名的状态,避免把一份内容改过的请求直接当成重试发出去。
服务端需要把幂等键和当前用户、接口操作绑定,保存关键请求字段的摘要,以及完成后用于恢复结果的信息,比如报名编号。收到同一个键和相同内容,已完成的请求返回原来的结果。内容有变化时,返回冲突并给出清楚的说明。接口还要约定键会保留多久,至少覆盖允许的重试时段。如果页面支持刷新后继续核对,也要能恢复已有的提交标识。超过保留时间后,前端可以引导用户去报名列表核对。
让数据库兜住同时到达的请求
如果实现只是先查键是否存在,再插入报名,两条并发请求就有机会都查到空结果。可以把用户编号、接口操作和幂等键一起设为唯一约束,让数据库决定谁取得写入资格。在报名数据和幂等记录位于同一个数据库的情况下,把占用键、创建报名和保存结果放在同一个事务里。抢到写入资格的一方完成事务,另一方在处理唯一键冲突后读取已提交的结果。如果第一份事务回滚,重复请求可以按接口约定再次尝试。对需要在事务之外慢慢处理的操作,可以让接口返回处理中状态,再由页面查询进度,省得连接一直挂着。
幂等键解决的是同一次操作的重放。有些活动还规定每个账号只能报一次,这时可以在报名表里另设一条唯一约束,用活动编号和账号编号来判断。有了这条规则,即使用户在两个标签页分别报名,两个不同的幂等键也只能对应一条有效报名。列表页和提交结果页都显示这条记录的编号,用户就能确认看到的是同一次报名。
联调时故意让响应慢下来
先把接口响应延迟几秒,连点按钮,再用回车提交。观察页面是否始终有明确提示,并从网络面板确认只发出了一次请求。接着让第一份请求在数据库提交后丢掉响应,等页面出现暂未确认的提示,再点击重试。核对前后两次请求用的是同一个键,返回的报名编号也与数据库里那一条一致。最后同时从两个标签页提交,查看数据库实际增加的记录数。如果支持刷新后恢复,就在提交结果尚未确认时刷新页面,检查页面能否找回这次提交。
我会把浏览器上看见的提示和服务端留下的记录一起核对。前者能看出用户何时该等、何时可以重试,后者能看出两份请求有没有变成两条报名。只要这两处都对得上,遇到网络忽快忽慢的时候,用户也能知道刚才那次操作走到了哪一步。