cPanel部署Django时Admin后台静态/CSS文件无法加载求助

第一步：修复manage.py运行报错问题 #

• 首先匹配Python执行版本：cPanel通常存在多版本Python共存的情况，直接执行python/python3调用的默认版本和项目依赖版本不一致会触发manage.py报错，替换为项目对应的Python版本执行命令即可，例如项目使用Python3.10就执行python3.10 manage.py collectstatic
• 检查manage.py的shebang声明：如果manage.py首行写了#!/usr/bin/env python这类指向系统默认Python路径的声明，会和项目虚拟环境的Python版本冲突，直接删除该行声明，或者修改为你项目虚拟环境Python解释器的绝对路径
• 确认已激活项目虚拟环境：cPanel部署的Django项目一般会配置独立虚拟环境，未激活环境运行manage.py会找不到项目依赖包从而报错，执行命令前先运行source /path/to/your/venv/bin/activate激活对应虚拟环境

第二步：修复Django Admin静态文件加载失败问题 #

解决collectstatic执行报错问题后，按以下步骤配置：

• 确认settings.py中的静态文件配置项正确：
  • 保证INSTALLED_APPS列表中已包含django.contrib.staticfiles
  • 配置STATIC_URL = '/static/'
  • 配置STATIC_ROOT为站点静态文件存放的绝对路径，示例：STATIC_ROOT = '/home/你的cPanel用户名/public_html/static/'
• 重新执行python manage.py collectstatic，出现确认提示时输入yes，执行完成后检查STATIC_ROOT目录下是否生成了admin子目录，子目录中包含css、js、img等Admin相关静态资源
• 检查静态目录权限：将STATIC_ROOT对应的目录及其所有子目录权限设置为755，静态文件权限设置为644，避免cPanel权限限制导致资源无法读取
• 若仍加载失败，可直接在站点根目录的.htaccess文件中添加Admin静态资源别名配置，替换为你自己的实际路径后生效：

Alias /static/admin/ /你的虚拟环境绝对路径/lib/python3.x/site-packages/django/contrib/admin/static/admin/
<Directory /你的虚拟环境绝对路径/lib/python3.x/site-packages/django/contrib/admin/static/admin>
    Require all granted
</Directory>

内容的提问来源于stack exchange，提问作者notVansh