Supervisor管理Python进程自动重启方法

Supervisor 虽常被用于守护 Python 进程并实现自动重启，但其机制极为“较真”——只有当 Python 进程不自行 daemon 化、且由 supervisord 直接 fork 启动（PPID 严格为 supervisord）时，autorestart=true 才真正生效；一旦脚本内调用 fork、启用 daemon 模式或 exitcode 设置不当，就会出现 status 显示 RUNNING 实际业务已“失联”的陷阱。本文直击生产环境中最易踩坑的五大核心问题：进程脱管识别与修复、exitcodes/startretries 等关键参数的精准配置、Python 输出缓冲导致的日志丢失与乱码、环境变量与路径隔离引发的启动失败，以及 supervisord 完全忽略 shell 配置的本质限制——每一条都附带可立即验证的诊断命令（如 ps -ef 查 PPID、supervisorctl tail 看实时 stderr）和零容错的配置范式，帮你把 Supervisor 从“看似在跑”真正变成“稳稳托住”。

Supervisor 不能直接管理 Python 脚本的“挂掉自动重启”，必须满足两个硬性前提：进程不能自行 daemon 化，且 supervisord 必须是它的直接父进程。否则 autorestart=true 形同虚设。

为什么 supervisorctl status 显示 RUNNING，但实际进程早没了？

这是最常见的误判场景——supervisord 确实启动了你的 Python 命令，但脚本内部调用了 os.fork()、启用了 daemon=True（如某些 Flask/Gunicorn 封装）、或执行了 sys.exit() 后又 fork 出子进程，导致真正干活的进程脱离了 supervisord 的子进程树。

此时 supervisord 只监控到“启动命令”退出（比如 Python 解释器执行完就退出），而不是业务进程退出，所以不会触发重启。

• 检查你的 Python 脚本是否显式调用 daemonize 或使用了 python-daemon 库
• 若用 Gunicorn，必须加 --daemon=False（或删掉 --daemon）并确保没配 daemon = true 在配置文件中
• Flask 默认不 daemon，但若套了 systemd-wrapper 或自写守护逻辑，就得砍掉
• 用 ps -ef | grep your_script.py 看 PPID 是否等于 supervisord 的 PID；不是就说明已脱管

配置里 autorestart=true 不生效的典型参数组合

光开 autorestart=true 远不够，它依赖 exit code 和信号行为判断“是否异常”。Python 进程静默退出、被 SIGKILL 强杀、或 exit code 被设为 0 都会导致 supervisord 认为“正常结束”，从而不重启。

• exitcodes=0,2：只把退出码为 0 或 2 视作“可接受”，其余都算异常；默认是 exitcodes=0，意味着只要脚本 exit(0)，哪怕你主动退出，supervisord 也不重启
• startretries=3：启动失败时重试次数，别设成 0 或 1；生产环境建议 ≥3
• stopwaitsecs=10：发 stop 信号后等 10 秒再 KILL，给 Python 的 atexit 或信号处理器留时间，避免强制中断导致状态残留
• killasgroup=false：默认值，表示只杀主进程；如果你的 Python 脚本会 fork 出多个子进程（如多线程/多进程爬虫），需设为 true，否则子进程变孤儿

Python 进程日志乱码、无法滚动、看不到 print 输出？

supervisord 默认捕获 stdout/stderr，但 Python 的输出缓冲机制会让日志延迟甚至丢失，尤其在非 TTY 环境下。

• 启动命令前加 python -u：强制未缓冲模式，例如 command=python -u myapp.py
• redirect_stderr=true 必须开启，否则 stderr 不进日志文件
• stdout_logfile=/var/log/myapp.log 要写绝对路径，且 supervisord 运行用户（通常是 root 或指定 user=xxx）必须有写权限
• 日志轮转靠 stdout_logfile_maxbytes 和 stdout_logfile_backups 控制，不配的话单个日志会无限增长
• 避免在脚本里用 logging.FileHandler 写同一路径日志，会造成竞争写入和乱序

supervisord 启动后，Python 进程没起来或反复 restart？

这通常不是代码问题，而是环境隔离或路径解析失败。supervisord 启动时的工作目录、PATH、Python 解释器路径和你手动执行时往往不一致。

• directory=/path/to/your/app 必须显式指定，否则 open("config.json") 这类相对路径会失败
• environment=PATH="/usr/local/bin:/usr/bin:/bin",PYTHONPATH="/opt/myapp" 显式注入关键环境变量
• 用绝对路径写 command：不要 command=python app.py，而要 command=/usr/bin/python3.9 /opt/myapp/app.py
• 如果用了 virtualenv，务必用虚拟环境里的 Python 解释器路径，例如 /opt/venv/bin/python，而不是系统全局的 python
• 首次启动失败时，用 supervisorctl tail -f your_program_name stderr 直接看错误堆栈，比翻日志快得多

最常被忽略的一点：supervisord 本身不读取你的 shell profile（~/.bashrc、/etc/profile），所以所有 PATH、LD_LIBRARY_PATH、甚至 PYTHONIOENCODING 都得在配置里显式声明。没声明，就是没有。

终于介绍完啦！小伙伴们，这篇关于《Supervisor管理Python进程自动重启方法》的介绍应该让你收获多多了吧！欢迎大家收藏或分享给更多需要学习的朋友吧~golang学习网公众号也会发布文章相关知识，快来关注吧！