Supervisor的autorestart=true生效前提是：Python进程不可daemon化，且supervisord必须是其直接父进程（PPID）；否则因fork、daemon=True或sys.exit()导致脱管，supervisord无法监控真实业务进程。
supervisord 必须是 Python 进程的直接父进程
Supervisor 的 autorestart=true 生效前提是：被管理的 Python 进程不能自行 daemon 化，且 supervisord 必须是它的直接父进程（PPID）。一旦脚本内部调用 os.fork()、启用 daemon=True（如某些 Gunicorn 封装）、或执行 sys.exit() 后再 fork 子进程，真实业务进程就会脱离 supervisord 的子进程树。
验证方式很简单：
- 运行
ps -ef | grep your_script.py，检查输出中该进程的 PPID 是否等于supervisord的 PID - 若 PPID 是 1（即 init/systemd）或其他非 supervisord 进程，说明已脱管
- 常见脱管源头：
python-daemon库、Gunicorn 配置了daemon = true或命令行带--daemon、Flask 脚本里手动双 fork
autorestart=true 为什么没触发重启？
autorestart=true 不是“只要进程没了就重启”，它依赖退出码和信号行为判断是否异常。以下情况都会导致不重启：
- Python 脚本静默退出（没抛异常、没显式
sys.exit(1)），且退出码为 0 - 进程被
SIGKILL强杀（无法捕获，supervisord 收不到退出信号） -
exitcodes配置太宽泛，默认exitcodes=0，意味着只把非 0 退出视为异常；若你主动sys.exit(0)，supervisord 认为“正常结束”
生产建议配置：
-
exitcodes=0,2：只接受 0 和 2 为“正常退出”，其余都触发重启（Python 常用错误码 1/2） -
startretries=3：启动失败时重试 3 次，避免因依赖未就绪（如 DB 连接）一次性失败 -
stopwaitsecs=10：发SIGTERM后等 10 秒再SIGKILL，给atexit或信号处理器留时间
日志看不到 print 输出？先查 redirect_stderr 和 stdout_logfile
Python 脚本的 print() 默认走标准输出（stdout），但 supervisord 默认不自动捕获 stdout/stderr，除非显式配置：
-
redirect_stderr=true：必须开启，否则 stderr 会丢失（很多异常只打到 stderr） -
stdout_logfile=/var/log/myapp.out.log：指定 stdout 日志路径，不设则不落盘 -
stderr_logfile=/var/log/myapp.err.log：同上，stderr 单独存更利于排查 - 避免用
logfile（这是 supervisord 自身日志），别和进程日志混淆
注意：如果 Python 脚本用了 logging 并配置了文件 handler，那 supervisord 的 stdout/stderr 日志就只含未被捕获的 print 或 unhandled exception —— 这是设计使然，不是 bug。
多进程 Python 程序（如爬虫、Gunicorn worker）要设 killasgroup=true
默认 killasgroup=false，supervisord 只 kill 主进程（PPID），子进程变成孤儿，继续跑着但不受控。对以下场景必须改：
- Gunicorn 启动多个 worker 进程（每个 worker 是独立子进程）
- Python 脚本用
multiprocessing或subprocess.Popen派生长期运行子进程 - 定时任务脚本 fork 出后台子任务
正确做法：
- 在 program section 中加
killasgroup=true - 同时配
stopasgroup=true（确保 stop 时也 kill 整个进程组） - 注意：这要求目标进程组支持 POSIX signal group，Linux 下没问题，macOS 行为略有差异
真正容易被忽略的是：即使你写了 autorestart=true，若子进程泄漏、资源占满、或主进程卡死但未退出，supervisord 也完全感知不到 —— 它只看主进程的生命周期。所以对关键服务，仍需在应用层做健康检查（比如 HTTP /health 端点），不能全押在 supervisord 上。
Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！
