Django 2.1.1升级至3.2版本后Admin管理面板界面变化问题咨询

操作与现象 #

• 执行操作：Ubuntu 18.04服务器环境下，将Django从2.1.1版本升级到3.2版本
• 异常现象：升级后Admin管理面板未保留原有样式，界面显示异常
• 运行环境：
  • 操作系统：Ubuntu 18.04.4 LTS (GNU/Linux 5.4.0-1048-aws x86_64)
  • Python版本：Python 3.6.9

故障原因 #

Django 3.2版本对Admin后台的默认静态资源（CSS、JS、字体文件等）做了大量迭代更新，升级后未同步更新静态文件、浏览器残留旧版本缓存是该问题的核心诱因。

修复步骤 #

1. 重新收集静态资源
   进入项目根目录，执行命令收集新版本Django的静态文件，覆盖旧版本文件：
   python manage.py collectstatic
   提示是否覆盖时输入yes确认即可。

2. 清除缓存验证
   静态文件更新完成后，按下Ctrl+Shift+R强制刷新Admin后台页面，清除浏览器本地缓存的旧样式资源。也可直接打开浏览器隐私/无痕模式访问Admin页面，确认样式是否恢复正常。

3. 自定义样式兼容检查
   如果项目中存在自定义Admin样式覆盖的配置，需要对照Django 3.2的官方Admin样式规则调整自定义代码，避免新旧版本样式冲突。同时确认settings.py中静态资源配置正确：

import os
STATIC_URL = '/static/'
STATIC_ROOT = os.path.join(BASE_DIR, 'static')

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