Django生产环境新增Admin模型不显示问题求助

针对生产环境新增Admin模型后管理面板不更新，但本地运行正常的情况，按以下步骤排查解决：

1. 确认生产环境代码已同步 #

确保本地修改的models.py、admin.py已推送到生产服务器，且部署流程加载了最新代码。例如用Git同步：

# 生产服务器执行拉取最新代码
git pull origin main

若用容器部署，需重新构建镜像并重启容器。

2. 重启生产服务器进程 #

Gunicorn、uWSGI等生产服务器是预加载代码的，代码变更后必须重启才能生效：

• 若用systemd管理Gunicorn：

sudo systemctl restart gunicorn

• 若用uWSGI：

uwsgi --reload /path/to/your/uwsgi.pid

3. 同步并刷新模型权限 #

新增模型后，手动同步权限并检查用户权限配置：

python manage.py migrate
python manage.py update_permissions

登录Admin后台，进入当前用户详情页，在「用户权限」中勾选新模型对应的查看、编辑权限。

4. 清除缓存 #

• 浏览器缓存：按Ctrl+Shift+R强制刷新页面，避免加载旧的Admin页面缓存。
• Django服务器缓存：若项目启用缓存，执行命令清除：

python manage.py clearcache

若用Redis等外部缓存，直接清空对应缓存存储。

5. 检查生产环境日志 #

查看服务器日志排查代码加载异常：

# 查看systemd管理的Gunicorn实时日志
sudo journalctl -u gunicorn -f

也可检查Nginx访问日志、Django应用日志，确认是否有语法错误或加载失败信息。

6. 验证模型注册状态 #

在生产服务器上通过shell验证模型是否成功注册：

python manage.py shell

执行以下代码：

from martinhensonphotography.models import AboutMe  # 替换为你的新模型
from martinhensonphotography.admin import admin
print(AboutMe in admin.site._registry)  # 输出True则表示注册成功

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