先确认python命令是否指向正确解释器，Supervisor默认用python而非python3调用脚本；宝塔常无/usr/bin/python软链或其指向损坏的Python 2.7，导致command not found或静默退出；需用ln -sf链接至/www/server/python/bin/python3等兼容Python 3.6+版本，并确保脚本及目录权限为r+x、command使用绝对路径、日志路径绝对化，状态卡在STARTING时应手动模拟www用户执行排查阻塞点。
Supervisor 启动任务失败时，先确认 python 命令是否指向正确解释器
Supervisor 默认用 python（不是 python3）调用脚本，而宝塔面板的 Python 环境往往没有 /usr/bin/python 软链，或它指向了已卸载/损坏的 Python 2.7。此时 Supervisor 会直接报 command not found 或静默退出。
执行以下命令验证：
which python<br>ls -l /usr/bin/python
若输出为空或提示 “No such file”，说明软链缺失。修复方式取决于你实际使用的 Python 版本：
- 如果宝塔用的是
/www/server/python/bin/python3（常见于 v8.x+），运行：ln -sf /www/server/python/bin/python3 /usr/bin/python - 若系统有
python3.9且你确认该版本兼容你的脚本，也可链接过去：ln -sf /usr/bin/python3.9 /usr/bin/python - 切勿强行链接到
python2.7—— Supervisor 插件本身依赖 Python 3.6+，错配会导致ImportError: No module named 'supervisor'
脚本文件和目录权限必须同时满足 r+x 才能被 www 用户执行
Supervisor 插件在宝塔中以 www 用户身份运行，它需要：对脚本文件有 read 权限（才能读取内容），对脚本所在目录有 execute 权限（才能进入该目录），对脚本本身有 execute 权限（才能作为可执行文件调用）。
常见错误是只改了脚本权限，忘了目录：
- 检查脚本权限：
ls -l /www/wwwroot/myapp/start.py→ 应含-rwxr-xr-x中的x - 检查脚本所在目录权限：
ls -ld /www/wwwroot/myapp→ 第三段（others）必须含x，即至少是drwxr-xr-x - 若目录权限是
drwxr-x---（末尾无x），则www用户无法进入，Supervisor 启动必失败，日志里只显示ERROR (no such file) - 修复命令：
chmod 755 /www/wwwroot/myapp和chmod 755 /www/wwwroot/myapp/start.py
Supervisor 配置中写绝对路径，别信 directory 能自动切换工作目录
Supervisor 的 directory 参数只是声明“启动前 cd 到这里”，但它不改变 Python 解释器查找模块的路径，也不影响相对路径的解析起点。很多用户以为设了 directory=/www/wwwroot/myapp 就能写 command=python start.py，结果因 import 失败而卡住。
让 macOS 自动化像说话一样简单 —— 用代码控制你的 Mac，无需学习 AppleScript 系统要求 macOS 14+ (Sonoma) Python 3.9+ 需要开启：辅助功能 + 屏幕录制权限
真实生效的路径逻辑是：
-
command必须用绝对路径调用 Python：command=/www/server/python/bin/python3 /www/wwwroot/myapp/start.py - 若脚本依赖虚拟环境，不能靠
directory激活，得显式调用：command=/www/wwwroot/myapp/venv/bin/python /www/wwwroot/myapp/start.py -
environment中要补全PYTHONPATH（如有自定义模块）：environment=PYTHONPATH="/www/wwwroot/myapp" - 日志路径也必须绝对：
stdout_logfile=/www/wwwroot/myapp/logs/supervisor.log
Supervisor 插件启动后状态为 STARTING 卡住？大概率是脚本内部阻塞或权限漏查
状态长时间停在 STARTING，而不是变成 RUNNING 或直接 FATAL，说明进程已拉起但没完成初始化 —— 这通常意味着脚本跑到了某处被挂起，比如：
- 尝试读写一个
www用户无权限的文件（如数据库 socket：/tmp/mysql.sock） - 等待网络连接（如 Redis、API）超时未设，卡在
socket.connect() - 用了
input()或sys.stdin.read()等交互式调用（Supervisor 不提供 stdin） - 日志目录不存在且脚本没做
os.makedirs()，导致第一次写日志就崩溃但没输出到 supervisor 日志中
最有效的排查方式是手动模拟 Supervisor 启动环境：
sudo -u www /www/server/python/bin/python3 /www/wwwroot/myapp/start.py
观察终端是否立即退出、报错或卡住 —— 这比看 Supervisor 日志更直接。卡住时按 Ctrl+C，看 traceback 最后一行在哪，基本就是问题根因。
Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！
