宝塔面板7.9的Python项目管理器无法直接部署Django项目，因其仅支持Flask和纯WSGI应用；需手动配置wsgi.py、uwsgi.ini，正确填写项目路径、启动文件（uwsgi.ini）及Python版本，并配置Nginx代理静态资源。
宝塔面板 7.9 自带的「Python项目管理器」不能直接部署 Django 项目——它只支持 Flask 和纯 WSGI 应用，Django 需要手动补全关键配置项，否则必然 500 或白屏。
为什么 Python项目管理器点“一键部署”后 Django 报错 ModuleNotFoundError: No module named 'django'
宝塔 7.9 的 Python项目管理器默认使用系统 Python（通常是 /usr/bin/python3），但 Django 并未全局安装；它也不会自动创建虚拟环境或执行 pip install -r requirements.txt。
- 它只读取你填的
项目路径、启动文件（如app.py）和端口，对manage.py或settings.py完全无感知 - 如果你在项目根目录下直接填
manage.py当启动文件，会报AttributeError: module 'manage' has no attribute 'application'——因为 Django 没有application对象，只有get_wsgi_application()返回的实例 - 真实可运行的入口必须是 WSGI 模块，比如
myproject.wsgi:application（注意冒号分隔）
必须手动创建的两个核心文件：wsgi.py 和 uwsgi.ini
宝塔不生成也不校验它们，但缺一不可。Django 项目根目录（即 manage.py 所在目录）下需确保：
-
wsgi.py文件存在且内容正确（Django 本身已生成，但常被忽略路径）：确认它位于myproject/myproject/wsgi.py（二级目录），而非项目根目录；若你用django-admin startproject myproject .创建，可能在根目录，此时需把它移到子目录并同步修改INSTALLED_APPS中的引用 -
uwsgi.ini必须手写，放在项目根目录，内容示例：[uwsgi] chdir = /www/wwwroot/my-django-app module = myproject.wsgi:application home = /www/wwwroot/my-django-app/venv master = true processes = 2 threads = 2 socket = 127.0.0.1:8001 chmod-socket = 660 vacuum = true die-on-term = true logto = /www/wwwlogs/my-django-app.uwsgi.log
其中home必须指向你的虚拟环境路径（推荐用宝塔「Python项目管理器」里勾选「使用虚拟环境」后自动生成的路径，如/www/wwwroot/my-django-app/venv）
宝塔后台填写时最关键的三个字段
进入「Python项目管理器」→「添加项目」，以下三项填错一个，后续全白搭：
立即学习“Python免费学习笔记（深入）”；
-
项目路径：填绝对路径，如/www/wwwroot/my-django-app（结尾不加斜杠） -
启动文件：填uwsgi.ini（不是manage.py，也不是wsgi.py）——这是宝塔调用 uWSGI 的唯一依据 -
Python版本：选你虚拟环境对应的版本（如python3.9），不是系统默认版本；如果没看到对应选项，先去「软件商店」安装对应 Python 版本，并勾选「设为默认」
其他字段如「运行目录」「启动命令」留空即可，宝塔会根据 uwsgi.ini 自动覆盖。
部署后访问 502 或静态资源 404 怎么办
502 多数是 uWSGI 没起来或端口冲突；404 静态资源说明 Nginx 没代理到 Django 的 static 目录。
- 检查
uwsgi.ini中socket端口是否被占用：netstat -tuln | grep :8001；若被占，换 8002、8003 等，并同步改 Nginx 配置里的proxy_pass http://127.0.0.1:8002 - Nginx 配置需额外加两段（在站点设置 → 配置文件末尾插入）：
location /static/ { alias /www/wwwroot/my-django-app/static/; } location /media/ { alias /www/wwwroot/my-django-app/media/; }注意alias结尾要有斜杠，且路径与 Django 的STATIC_ROOT一致（记得先运行python manage.py collectstatic --noinput） - 日志永远是最准的线索：
tail -f /www/wwwlogs/my-django-app.uwsgi.log和tail -f /www/wwwlogs/my-django-app.error.log
真正卡住的地方往往不是 Django 本身，而是宝塔把 uWSGI 当成黑盒、不暴露其加载过程，所有路径、权限、模块导入问题都得靠日志反推。
