Python脚本在CentOS宝塔中运行失败的根源常是Python版本混乱、启动类型选错、依赖未装入项目虚拟环境及日志被吞；应统一用python3、选对Web应用/守护进程类型、用项目指定Python路径装包，并查supervisor原生日志定位真实错误。
Python脚本在CentOS上跑不起来，先看python命令指向谁
很多问题根源不在代码，而在系统里根本没装对版本，或者python软链接指向了Python 2。宝塔面板默认可能只装了python3，但你的脚本第一行写的是#!/usr/bin/env python，结果就卡在找不到解释器。
- 执行
which python和which python3，确认两者是否存在 - 运行
python --version和python3 --version，别假设它们一样 - 如果
python报错或输出是2.7，别硬改脚本，用ln -sf /usr/bin/python3 /usr/bin/python（仅限你完全掌控服务器且无其他依赖Python 2的服务） - 更稳妥的做法：脚本开头统一改成
#!/usr/bin/env python3，所有调用都显式用python3
宝塔面板里添加Python项目，关键不是“添加站点”，而是选对运行环境
宝塔的“Python项目”功能本质是用Supervisor托管一个长期运行的进程，不是部署Web服务的万能入口。如果你只是想定时跑个数据抓取脚本，或者启一个FastAPI服务，选错类型会导致进程秒退、日志空白、端口被占却访问不到。
- 确认你的程序类型：
flask/fastapi类Web服务 → 选“Web应用”类型，并填对启动命令，比如gunicorn main:app -b 0.0.0.0:8000 - 纯后台脚本（如每5分钟查一次数据库）→ 选“守护进程”，启动命令写
python3 /www/wwwroot/mytask/task.py，并勾选“自动重启” - 千万别把
requirements.txt路径填错——宝塔会去读这个文件装包，路径必须是绝对路径，且文件得真存在、格式规范（不能有多余空行或注释符号#混在包名行里） - 权限问题常被忽略：确保运行用户（默认
www）对脚本、依赖目录、日志路径都有读写权限，chown -R www:www /www/wwwroot/myproject
ModuleNotFoundError：不是没装包，是没在对的环境下装
你在SSH里用pip3 install requests成功了，但宝塔里还是报找不到模块？大概率是因为宝塔Python项目默认用的是它自己创建的虚拟环境（路径类似/www/server/pyenv/versions/3.9.18），而你装包装到了系统级pip3下。
- 进宝塔 → Python项目 → 点开你的项目 → “运行环境”里看“Python路径”，记下那个
bin/python的完整路径 - 用这个路径装包：
/www/server/pyenv/versions/3.9.18/bin/python -m pip install requests - 或者直接在宝塔界面点“安装扩展模块”，它会自动用对的
pip；但注意：有些C扩展（如psycopg2）需要先yum install postgresql-devel gcc再装 - 别信
pip list的输出——它反映的是当前shell环境，不是宝塔后台实际用的那个
调试时看不到错误？别只刷宝塔日志页面
宝塔界面显示“运行中”，但请求没响应、脚本没输出，往往是因为错误被吞了，或者日志根本没写到宝塔监控的路径。
立即学习“Python免费学习笔记（深入）”；
- 先看Supervisor原生日志：
tail -f /www/wwwlogs/supervisor.log，里面会有子进程崩溃的真实原因（比如OSError: [Errno 98] Address already in use） - 你的Python代码里加
import logging; logging.basicConfig(level=logging.INFO)，并确保print()没被缓冲——加flush=True或启动时加-u参数：python3 -u main.py - 如果用
gunicorn，加上--capture-output --log-level debug，否则HTTP 500错误可能只在worker进程里闪一下就没了 - 最狠一招：在启动命令前加
nohup和重定向，比如nohup python3 task.py > /tmp/task.log 2>&1 &，绕过所有中间层直看输出
