宝塔面板7.9配置Python环境及Django部署教程

宝塔面板7.9虽内置Python项目管理器，却无法直接一键部署Django项目——它仅原生支持Flask和纯WSGI应用，而Django需手动补全wsgi.py入口配置、编写uwsgi.ini启动文件、精准填写项目路径/启动文件（必须是uwsgi.ini而非manage.py）/Python版本（须匹配虚拟环境），稍有偏差即触发500错误、ModuleNotFoundError或502网关异常；本文直击部署卡点：从虚拟环境缺失、application对象误用、静态资源404到uWSGI端口冲突，手把手教你通过日志定位、Nginx代理配置和路径规范实现稳定上线，让Django在宝塔上真正跑起来。

宝塔面板 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 当成黑盒、不暴露其加载过程，所有路径、权限、模块导入问题都得靠日志反推。

以上就是本文的全部内容了，是否有顺利帮助你解决问题？若是能给你带来学习上的帮助，请大家多多支持golang学习网！更多关于文章的相关知识，也可关注golang学习网公众号。