HUP信号可实现Flask零停机重启，但需Gunicorn以master-worker模式运行且配置graceful-timeout、timeout和pidfile正确，否则将导致连接重置或服务中断。
HUP信号确实能实现Flask应用的零停机重启，但前提是Gunicorn以正确方式运行且配置得当——否则你看到的只是“假平滑”，旧worker卡住、连接被重置、日志里满屏Worker exiting警告。
怎么确认你的Gunicorn正在用master-worker模式跑
零停机的前提是存在一个长期存活的master进程，它负责接收信号并协调新旧worker切换。如果你用gunicorn app:app --preload启动，但没加--daemon或没通过systemd管理，很可能根本没生成master进程。
- 执行
ps aux | grep gunicorn，看到至少两行：一行带master字样（通常是第一个PID），其余是worker - 检查
ps -o pid,ppid,comm -C gunicorn输出，确认worker的PPID指向同一个父进程ID - 如果只看到一堆独立的
gunicorn进程，说明你启用了--preload但master被绕过了，或者误用了--reload（开发模式，不支持HUP）
发送HUP前必须检查的三个配置项
很多“HUP后服务中断”问题，其实不是信号本身失效，而是配置让Gunicorn无法完成优雅过渡。
-
graceful-timeout必须大于你最长请求耗时——默认30秒，但香港/跨境API常有60秒以上响应，设太小会导致旧worker被强制杀掉，正在处理的请求直接Connection reset -
timeout要略大于graceful-timeout，否则worker可能在等待关闭时先因超时被干掉 - 没设
pidfile？那你每次都要手动ps aux | grep gunicorn | head -1 | awk '{print $2}'找master PID，容易发错目标——建议在gunicorn.conf.py里固定写pidfile = "/var/run/gunicorn.pid"
实际执行HUP时最常踩的坑
命令本身很简单，但环境细节决定成败。
立即学习“Python免费学习笔记（深入）”；
- 别用
kill -HUP $(cat gunicorn.pid)而没校验文件是否存在——如果上一次异常退出导致pid文件残留，你会向一个已死PID发信号，返回No such process却误以为成功了 - 发完信号立刻
curl -I http://localhost:8000验证？别急。新worker启动需要时间，尤其加载了大型ML模型或数据库连接池时，头几秒503 Service Unavailable是正常的，等gunicorn.access.log里出现新worker的PID再测 - 用Nginx做反向代理时，确保
upstream里没配max_fails=1——HUP过渡期少量502会触发Nginx把worker标记为down，导致流量被切走
为什么有时候HUP看起来“没反应”
这不是bug，而是Gunicorn的保守策略在起作用。
- 如果新worker启动失败（比如代码语法错误、import失败、DB连接超时），master会停止关闭旧worker，并继续用老版本服务——此时
gunicorn.error.log里会有Booting worker with pid: XXX后紧跟Worker exited with code 1 - 旧worker不会自动退出，它们会一直等到
graceful-timeout超时才强制终止，所以你以为“卡住了”，其实是Gunicorn在给你留抢救时间 - 这时候别狂按HUP，先查error log，修好代码，再发一次——重复发HUP不会加速，反而可能堆积未处理信号
真正关键的不是“怎么发HUP”，而是发之前有没有确认master活着、配置撑得住、日志看得见。线上服务没有“试一下”的余地，每个信号都该带着上下文去发。
