部署在PythonAnywhere的Django Admin页面渲染异常原因排查

部署到PythonAnywhere后，Django Admin登录页面样式异常，浏览器控制台出现MIME类型错误（示例：Refused to apply style from 'example.com/static/admin/css/dark_mode.css' because its MIME type ('text/html') is not a supported stylesheet MIME type, and strict MIME checking is enabled.），同时服务器错误日志显示大量静态资源找不到（如Not Found: /static/admin/css/dark_mode.css）。已执行python manage.py collectstatic但问题仍存在，可按以下步骤排查：

1. 检查PythonAnywhere静态文件映射配置 #

PythonAnywhere不会自动关联Django的静态资源路径，必须手动配置静态文件映射：

• 登录PythonAnywhere后台，进入你的Web应用管理页面
• 找到「Static files」板块
• 添加一条映射规则：URL填写/static/，Directory填写你的STATIC_ROOT路径/home/mywebsite/surveys/static
• 保存配置后，重新加载Web应用

2. 验证collectstatic执行有效性 #

• 登录PythonAnywhere控制台，激活项目对应的虚拟环境（若使用了虚拟环境），重新执行python manage.py collectstatic，观察是否有报错信息
• 检查/home/mywebsite/surveys/static目录下是否存在admin文件夹，且该文件夹内包含css、js等子目录及对应静态文件。若不存在，说明collectstatic未正确收集Django自带的Admin静态资源，可能是虚拟环境未激活、Python环境错误或Django安装异常导致。

3. 核对settings.py配置细节 #

• 确保DEBUG = False：生产环境必须关闭DEBUG模式，否则Django会自行处理静态资源，绕过PythonAnywhere的静态文件映射规则
• 确认BASE_DIR定义正确，标准写法为：

  from pathlib import Path
  BASE_DIR = Path(__file__).resolve().parent.parent
  

• STATICFILE_DIRS用于存放项目自定义静态文件，不影响Admin静态资源的收集，无需修改，但需确保路径指向正确。

4. 检查静态文件目录权限 #

在PythonAnywhere控制台执行以下命令，确保静态资源目录及文件具备可读权限：

chmod -R 755 /home/mywebsite/surveys/static
chmod -R 644 /home/mywebsite/surveys/static/*

内容的提问来源于stack exchange，提问作者Bob The Builder