接口幂等:三个常见错误与对应写法
重试是分布式系统的基本动作,幂等是它的前提。写错幂等,重试就从保护机制变成故障源。
错误一:用时间戳判重
拿请求时间做去重键,等于假设时钟可靠。多实例时钟漂移、重试时间接近,都会让判重失效。
正确做法是用客户端生成的请求标识,服务端按标识做短期去重,并设定明确的过期窗口。
错误二:先写库再校验
在校验通过前就落库,重复请求会把脏数据写进去。并发下两个请求同时通过校验,问题更明显。
把判重交给数据库的约束,用插入冲突来兜底,比在应用层自己判重可靠。
错误三:状态机没有中间态
只有成功与失败两态,重试时无法区分"已处理"和"未处理"。加上处理中状态,并给出超时回收规则。
回收动作本身也要幂等,否则清理任务会重复触发副作用。
查询类接口也要小心
读接口看似天然幂等,但如果带缓存写入或统计累加,就不再是纯读。把副作用拆出去,读路径保持干净。
统计类需求改成事件流异步汇总,比在接口里直接累加稳妥。
怎么验证
在测试环境重放同一请求十次,看结果是否一致、副作用是否只发生一次。并发重放与超时重放各测一轮。
把幂等测试纳入回归,接口改动时自动跑,避免后续迭代破坏原有约定。
本文由合亚嗒资讯网编辑部整理撰写,观点仅供参考;转载请注明来源与链接。