宝塔面板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项目管理器」→「添加项目」,以下三项填错一个,后续全白搭:
-
项目路径:填绝对路径,如/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 当成黑盒、不暴露其加载过程,所有路径、权限、模块导入问题都得靠日志反推。
Python免费学习笔记(深入):立即使用
在学习笔记中,你将探索 Python 的核心概念和高级技巧!










