[!info] 关联笔记

• 所属 MOC：系统与服务 · 学习路线
• 前置概念：async、Tokio、HTTP 服务
• 后续概念：可观测、Docker
• 容易混淆：Drop 清理

Rust 优雅关闭

这个概念为什么出现

kill -9 式退出会打断请求、丢消息。
优雅关闭：收信号 → 停止准入 → 等待飞行中工作 → 释放资源 → 退出。

[!abstract] 一句话理解 监听 SIGTERM/SIGINT，取消服务 future，给飞行中请求一个宽限期，超时再强制结束。

最小可运行示例

场景：关闭协议状态机（逻辑示意）

// 业务意图：用枚举表达关闭阶段。
// 教学点：阶段清晰；真实实现接 signal hook。

#[derive(Debug)]
enum Phase {
    Running,
    Draining,
    Stopped,
}

fn main() {
    let mut phase = Phase::Running;
    println!("got SIGTERM");
    phase = Phase::Draining;
    println!("wait in-flight <= 30s: {phase:?}");
    phase = Phase::Stopped;
    println!("exit 0: {phase:?}");
}

Tokio 中常见：signal::ctrl_c() 与 axum::serve(...).with_graceful_shutdown(...)。

结合场景再看三个关注点

1. K8s 先 SIGTERM
2. ** readiness 先失败再排空**
3. 超时防挂死

工程实践

1. 统一 CancellationToken
2. 工作者监听取消
3. 关闭指标
4. 本地用 ctrl-c 测

本节总结

• 关闭是协议
• 信号 + 排空 + 超时
• 与编排系统协作

自测题

1. 为何 readiness 要在 drain 前变失败？
2. 只有 Drop 够不够？

参考答案

1. 停止新流量进入。
2. 不够，需要协作式停止异步任务与监听端口。

延伸阅读与资料来源

资料	类型	支撑内容
Tokio signal	生态	信号
axum graceful shutdown examples	生态	框架集成