幂等键测试

幂等键(Idempotency-Key 或业务去重键)让重试安全:同一键的重复请求应返回首次结果或明确冲突,并发下仅生效一次;支付、订单与回调类接口的测试重点。

软件测试速查开发更新于 2026-10-12

重复提交示意

重复提交示意
curl -sS -X POST https://api.example.com/v1/payments \
  -H 'Idempotency-Key: 7f9c2ba4e88f827d616045507605853e' \
  -H 'Content-Type: application/json' -d '{"amount": 100}'

# 使用同一键重发,应得到与首次一致的结果
幂等键需要明确有效期与去重存储策略;测试覆盖重复提交、并发双发与键过期后的行为。

易错点

  • 每次重放都用新键,实际未验证去重逻辑
  • 并发双发与顺序重放混测,无法区分竞态与幂等问题

数据来源与参考

  • IETF 草案:The Idempotency-Key HTTP Header Field
  • Stripe API 文档(幂等键使用说明)
​‌‌​​‌​​​‌‌​‌‌‌‌​‌‌​​​‌‌​‌‌‌​​‌‌​​‌​‌‌‌​​‌‌‌​​​‌​‌‌​‌​​‌​‌‌‌​​​‌​‌‌​‌​​‌​‌‌​​​‌‌​‌‌‌​‌​​​‌‌​‌‌‌‌​​‌​‌‌‌​​‌‌​​​‌‌​‌‌​‌‌‌‌​‌‌​‌‌​‌