Request Deadline
请求截止时间
请求截止时间是客户端不再等待的时间点。后续服务只能使用当时剩余的时间。
absolute deadline -> remaining timeout -> propagate -> cancel -> stop spawned work13:00:00.800剩余 620 毫秒absolute deadline -> remaining timeout -> propagate -> cancel -> stop spawned workSRE另一个例子
结账请求一开始有 800 毫秒。API 把剩余的 620 毫秒交给库存服务。时间归零时,请求会取消。服务器还要停止这次请求派生的任务。
主要部分
- 01开始时间
- 02截止时间点
- 03已用时间
- 04剩余时间
- 05取消信号
- 06停止与清理流程
什么时候用
远程调用要设置截止时间。截止时间要按用户需求和实测延迟决定。每一层都要传递剩余时间。
什么时候不要用
不要在没有数据时随便设置很短的截止时间。客户端停止等待还不够。服务器也要收到取消信号并停止工作。
代码里的名称
absolute deadline -> remaining timeout -> propagate -> cancel -> stop spawned work 上线前要检查
检查接口约定、任何情况下都不能破坏的规则、授权与输入限制。测试重试、重复执行只生效一次、超时与部分失败。验证数据完整性、兼容性、监控、恢复与回到上一版。
预期结果:为这套系统设计或检查 请求截止时间 (Request Deadline),并让数据保持正确、安全且容易维护。 用户场景:结账请求一开始有 800 毫秒。API 把剩余的 620 毫秒交给库存服务。时间归零时,请求会取消。服务器还要停止这次请求派生的任务。 技术概念或控制措施:请求截止时间 (Request Deadline)。 适用理由:远程调用要设置截止时间。截止时间要按用户需求和实测延迟决定。每一层都要传递剩余时间。 不应使用的情况:不要在没有数据时随便设置很短的截止时间。客户端停止等待还不够。服务器也要收到取消信号并停止工作。 工程要求:定义输入、输出、接口约定,以及任何情况下都不能破坏的规则。说明授权与输入检查范围。定义失败、超时、重试和重复执行只生效一次的规则。也要定义数据迁移与兼容限制。 运营要求:加入监控信号与隐藏敏感数据的日志。设置容量上限并写好操作手册。测试恢复与回到上一版的流程。 验收标准:接口约定与失败路径测试通过。重试或部分失败时,数据与授权规则仍正确。性能上限、监控、恢复与回到上一版的方法都已验证。 证据与限制(证据边界):没有一份官方标准能涵盖全部内容。不同团队、平台或框架的用法可能不同。 待确认:程序运行环境、数据位置、流量形态、数据一致需求和安全边界。也要确认兼容周期、服务目标(SLO)与恢复上一版的限制。
检查这份需求
请 AI 编程助手检查当前如何使用 请求截止时间 (Request Deadline)。 定义:请求截止时间是客户端不再等待的时间点。后续服务只能使用当时剩余的时间。 生产环境检查:检查接口约定、任何情况下都不能破坏的规则、授权与输入限制。测试重试、重复执行只生效一次、超时与部分失败。验证数据完整性、兼容性、监控、恢复与回到上一版。 修改程序前,先列出看到的证据、缺口、严重程度,以及最小且安全的修正。