请求幂等性

request_idempotency2026-10-16 18:03:58

请求幂等性要求重复执行同一逻辑操作与执行一次具有相同的预期业务效果,不要求每次响应文字、时间或审计记录完全相同。

幂等键

对创建订单等写操作,可以用客户端请求标识表达同一操作意图,服务端原子登记键、关联请求参数及结果。并发重复请求应由唯一约束或等效机制协调,不能仅靠先查后写。

相同键配不同参数应拒绝或按明确规则处理;键的租户范围、保留时间和处理中状态都需定义。

超时与重试

客户端超时可能发生在服务端已提交之后,不能据此直接再次创建新操作。幂等记录与业务提交应协调,避免只记录“已处理”却没有业务结果,或写入成功却未记幂等状态。

参考资料

本页目录