Django admin后台已注册的advertisements应用未展示是什么原因？

常见原因 #

• 未执行应用迁移：如果advertisements应用的模型未执行makemigrations和migrate操作，Django不会生成对应的ContentType记录，admin后台就不会显示该应用入口
• admin文件异常：advertisements目录下的admin文件命名错误（如写成Admin.py、adminn.py）、位置放错，或者目录下缺少__init__.py文件，都会导致Django无法识别加载admin配置
• 登录用户无权限：如果当前登录admin的不是超级用户，且未分配advertisements应用下模型的访问权限，也会看不到该应用
• 模型注册失败：admin.py中注册的AdvertisingSpace模型不存在或类名拼写错误，会导致注册逻辑失效，无注册模型的应用默认不会在admin展示
• 应用配置不匹配：apps.py中配置的name参数和实际应用目录名不匹配，或者INSTALLED_APPS中应用路径拼写错误，会导致应用未被正确加载
• 缓存问题：Django运行生成的pycache缓存可能导致新添加的应用配置未生效

排查步骤 #

1. 确认当前登录admin后台的是超级用户账号
2. 执行迁移命令，完成应用模型的数据库初始化：

python manage.py makemigrations advertisements
python manage.py migrate

3. 核对advertisements应用的目录结构，确保符合以下规范：

advertisements/
    __init__.py
    admin.py
    apps.py
    models.py
    # 其他应用文件

4. 检查models.py中确实存在AdvertisingSpace模型类，拼写与admin.py中注册的一致
5. 删除项目下所有__pycache__目录，重启Django运行服务，查看控制台是否有注册模型相关的报错信息

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