展开知识库目录
文件上传、分页、重试和超时怎么写进接口验收
上传、分页、重试和超时不是实现细节，它们决定数据是否重复、丢失或卡死。
接口边界要写成可执行用例
上传、分页、重试和超时不是实现细节，它们决定数据是否重复、丢失或卡死。验收应覆盖大小、顺序、中断和幂等，而不只测一次成功请求。
文件上传
格式、大小、分片、校验和、重复文件、恶意内容和存储失败。
把涉及的文件、目录、版本、命令和实际输出写进记录；代码变化同时保留 diff 与测试结果。
分页
排序稳定、游标或页码、空页、末页、新增删除并发。
确认“分页”已经有可回查结果，再进入“重试”；依据仍然来自猜测时，把缺口单列并停在当前步骤。
重试
只对适合的瞬时失败重试，设置次数、退避和幂等键。
确认“重试”已经有可回查结果，再进入“超时与取消”；依据仍然来自猜测时，把缺口单列并停在当前步骤。
超时与取消
连接、读取、整体任务和上游超时分别处理，支持客户端取消。
确认“超时与取消”已经有可回查结果，再进入“观测”；依据仍然来自猜测时，把缺口单列并停在当前步骤。
观测
请求 ID、批次、状态、耗时和错误层可关联。
需要修改时先限定文件和行为范围，无法说明回滚方式或影响面的动作先不执行。 完成后把证据归入“边界用例与接口测试表”。
完成后应能在“边界用例与接口测试表”中找到与这一步对应的记录；仍需靠猜测补全，就停在这里。
用故障注入证明边界有效
主动制造大文件、断网、重复请求、慢上游和中途取消，检查结果、日志和重试。只在正常网络下一次成功不能通过验收。