supervisor不能直接启动python web进程，因其要求被管程序前台运行且不自行daemonize；flask需禁用debug/use_reloader，django应改用gunicorn等生产服务器，并确保command为绝对路径、配置stopasgroup=true等关键项。
Supervisor为什么不能直接启动Python Web进程
Supervisor本身不支持直接用python app.py这种交互式命令启动Web服务，因为多数Python Web框架（如Flask、Django）默认以开发模式运行，会启用重载、调试器或阻塞式I/O，导致Supervisor误判进程已退出。它要求被管理的程序必须是「前台运行、不自行daemonize」的常驻进程。
实操建议：
- Flask项目务必禁用
debug=True和use_reloader=True，改用app.run(host='0.0.0.0:5000', debug=False, use_reloader=False) - Django项目不要用
python manage.py runserver，应改用gunicorn myproject.wsgi:application --bind 0.0.0.0:8000 --workers=2这类生产级WSGI服务器 - 确保启动命令不带
&、nohup或daemon=True参数，否则Supervisor会失去对主进程的控制
supervisord.conf里program段的关键配置项
一个能稳定拉起Python Web进程的[program:myweb]段，核心在于进程生命周期控制和环境隔离。漏掉任意一项都可能导致启动失败、日志丢失或自动重启失效。
实操建议：
-
command必须写绝对路径，比如/usr/local/bin/gunicorn myapp.wsgi:application --bind unix:/tmp/myapp.sock，避免因工作目录不一致导致模块导入失败 -
directory设为项目根目录（如/opt/myapp），否则Python可能找不到settings.py或静态文件 -
environment要显式声明PYTHONPATH="/opt/myapp"和PATH="/usr/local/bin:/usr/bin"，尤其当使用虚拟环境时 -
autostart=true和autorestart=unexpected是标配；避免用autorestart=true，否则HTTP 500也会触发重启，掩盖真实异常 -
stopasgroup=true和killasgroup=true必须开启——Gunicorn等会派生子进程，否则supervisorctl stop只杀主进程，子进程变僵尸
常见错误：supervisorctl status显示STARTING或FATAL
这通常不是Supervisor坏了，而是被管进程在启动瞬间就崩溃了，Supervisor来不及捕获stdout/stderr。最有效的排查路径是绕过Supervisor直跑命令，再比对输出。
实操建议：
- 先手动执行
sudo -u www-data /usr/local/bin/gunicorn myapp.wsgi:application --bind 0.0.0.0:8000 --log-level debug，观察是否报ImportError或PermissionError - 检查
stderr_logfile和stdout_logfile路径权限，Supervisor默认以root读配置，但以user字段指定的用户身份运行进程，日志目录需对该用户可写 - 若报
unix://: No such file or directory，说明socket路径父目录不存在，需提前mkdir -p /var/run/myapp并赋权 - 遇到
can't find command，不是PATH问题就是二进制不在PATH中，直接写/home/venv/bin/gunicorn更可靠
Web进程需要响应SIGTERM而非SIGKILL
Supervisor默认发SIGTERM停止进程，但很多Python脚本没注册信号处理器，导致连接被粗暴中断、数据库事务未提交、临时文件未清理。这不是Supervisor的错，是应用层缺失。
实操建议：
- Gunicorn用户应在
gunicorn.conf.py中加graceful_timeout = 30和timeout = 60，确保收到TERM后有足够时间处理完请求 - 自研脚本需在主循环前注册
signal.signal(signal.SIGTERM, cleanup_handler)，并在cleanup_handler里关闭数据库连接、释放锁、写入状态文件 - 避免在
command里套shell脚本（如sh start.sh），除非该脚本自己处理信号转发；否则TERM只会发给shell，子进程收不到
真正麻烦的从来不是配置几行supervisord.conf，而是确认你的Python Web进程在被SIGTERM击中时，到底会不会优雅收尾——这点不验证，上线后连接重置、数据不一致都是静默发生的。
Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！
