自定义Admin集成django-admin_index时app_list路由匹配失败

我搭建了自定义Admin页面并添加了所需链接，代码原本运行正常，但在使用django-admin_index后出现以下错误：

NoReverseMatch at /admin/ Reverse for 'app_list' with keyword arguments '{'app_label': 'admin_index'}' not found。

项目仅包含一个名为myapp的应用，我尝试重写CustomAdminSite的app_list方法但未解决问题，推测是自定义Admin未正确继承django-admin_index所需的组件（如app_list）导致的。

初始admin.py #

# 自定义Admin界面
class CustomAdminSite(admin.AdminSite):
    def get_urls(self):
        urls = super().get_urls()
        custom_urls = [
            path('analytics/', self.admin_view(analytics_view), name='custom_analytics'),
        ]
        return custom_urls + urls 

custom_admin_site = CustomAdminSite(name='custom_admin')

Admin路由urls.py #

from django.urls import path, include
from django.conf.urls.static import static
from django.conf import settings
from myapp.admin import custom_admin_site  

urlpatterns = [
    path('admin/', custom_admin_site.urls),  # 注册自定义Admin URL
    path('', include('myapp.urls')),
]

if settings.DEBUG:
    urlpatterns += static(settings.MEDIA_URL, document_root=settings.MEDIA_ROOT)

自定义Admin模板base_site.html #

{% extends "admin/base.html" %}

{% block branding %}
<h1 id="site-name"><a href="{% url 'admin:index' %}">SDM Administration</a></h1>
{% endblock %}

{% block user-tools %}
<ul class="user-tools">
    <li><a href="#">Test Link</a></li>
    <li><a href="{% url 'admin:password_change' %}">Change password</a></li>
    <li><a href="{% url 'logout' %}">Log out</a></li>
</ul>
{% endblock %}

{% block nav-global %}
<ul class="nav-global">
    <li>
        <a href="{% url 'admin:custom_analytics' %}" class="reports-link">Reports and Analytics</a>
    </li>
</ul>
<style>
    /* 导航全局样式和报告链接样式 */
    .nav-global {
        display: inline-block;
        margin-left: 30px;
        margin-top: 10px;  /* 向下移动按钮3px */
        list-style-type: none;  /* 移除项目符号（黄色框） */
        padding-left: 0;  /* 确保没有左内边距 */
    }
    .nav-global > li {
        display: inline-block;
    }
    .nav-global .reports-link {
        color: #fff;
        background-color: #2B3C4D; /* 蓝色背景 */
        padding: 5px 15px;
        border-radius: 3px;
        text-decoration: none; 
        font-weight: bold;
        transition: background-color 0.3s ease;
    }
    .nav-global .reports-link:hover {
        background-color: #1d5a8a;
    }
</style>
{% endblock %}

修改后的admin.py #

class CustomAdminSite(AdminSite):
    site_header = "SDM Administration"
    site_title = "SDM Admin Portal"
    index_title = "Welcome to the SDM Admin Portal"
    site_url = '/tree/'

    def get_urls(self):
        urls = super().get_urls()
        custom_urls = [
            path('analytics/', self.admin_view(analytics_view), name='custom_analytics'),
        ]
        return custom_urls + urls

    def app_list(self, request, app_label):
        context = {
            **self.each_context(request),
            'title': self.get_app_list_title(app_label, request),
            'app_label': app_label,
            'app_url': '',
        }
        return TemplateView.as_view(template_name='admin/app_list.html', extra_context=context)(request)

custom_admin_site = CustomAdminSite(name='custom_admin')

1. 替换继承的AdminSite类 #

django-admin_index提供了专属的AdminSite实现，自定义站点必须继承它，才能处理admin_index应用的路由解析问题：

修改admin.py的导入和继承逻辑：

# 替换原生AdminSite导入，改用django-admin_index的实现
from django_admin_index.admin import AdminSite
from django.contrib.admin import register
from django.urls import path
from .views import analytics_view

class CustomAdminSite(AdminSite):
    site_header = "SDM Administration"
    site_title = "SDM Admin Portal"
    index_title = "Welcome to the SDM Admin Portal"
    site_url = '/tree/'

    def get_urls(self):
        urls = super().get_urls()
        custom_urls = [
            path('analytics/', self.admin_view(analytics_view), name='custom_analytics'),
        ]
        return custom_urls + urls

custom_admin_site = CustomAdminSite(name='custom_admin')

# 注意：所有模型都要通过这个自定义站点注册，比如：
# from .models import YourModel
# custom_admin_site.register(YourModel)

2. 删除错误的app_list重写 #

你之前重写的app_list方法完全替换了父类逻辑，导致django-admin_index无法处理自身的admin_index应用请求。直接删除这个方法，让自定义站点继承django-admin_index的app_list实现即可。

3. 验证模板兼容性 #

你的base_site.html仅修改了branding、用户工具和全局导航，无需额外调整，确保模板继承的admin/base.html是django-admin_index提供的版本即可（安装库后会自动覆盖或扩展原生模板）。

4. 确认路由配置 #

当前urls.py的配置是正确的，确保没有其他地方注册原生admin.site.urls，避免命名空间冲突。

错误原因解析 #

django-admin_index会在Admin界面添加一个名为admin_index的虚拟应用入口，但你的自定义站点最初继承的是原生admin.AdminSite，原生类没有处理app_label='admin_index'的反向路由解析逻辑，导致出现NoReverseMatch错误。继承django-admin_index的AdminSite后，它会自动处理这个虚拟应用的路由和视图，解决反向解析问题。

内容的提问来源于stack exchange，提问作者Khalsi Aziz