部署服务器后Django admin登录页面显示异常求助

核心排查与修复步骤 #

• 确认静态文件已收集：
  生产环境下Django不会自动托管静态文件，必须执行收集命令：
  python manage.py collectstatic
  检查服务器上STATIC_ROOT配置的目录下，是否存在admin相关的css、js、img文件夹，确保所有静态资源已正确归集。

• 检查静态文件权限：
  确保Web服务器进程（如nginx、www-data用户）能读取静态文件目录，执行权限调整命令：
  chown -R www-data:www-data /path/to/your/static_root
chmod -R 755 /path/to/your/static_root

• 验证生产环境配置：
  确认settings.py中DEBUG = False，同时ALLOWED_HOSTS已添加服务器的域名或IP。错误的ALLOWED_HOSTS配置可能导致资源加载被拦截。

• 核对Web服务器静态路由：
  检查Nginx/Apache的配置文件，确保将STATIC_URL对应的路径（如/static/）正确映射到STATIC_ROOT目录。以Nginx为例，需添加类似配置：

  location /static/ {
      root /path/to/your/project;
      expires 30d;
  }
  

• 清除缓存：

  • 强制刷新浏览器（Ctrl+F5），避免加载本地缓存的旧样式
  • 若使用CDN或服务器缓存，清空对应缓存资源

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