Django静态Sitemap报错：Reverse for 'index'未找到，求解决方案

问题情况 #

配置Django站点地图后，动态站点地图能正常工作，但静态站点地图抛出错误：

"Reverse for 'index' not found. 'index' is not a valid view function or pattern name."

问题根源 #

1. URL路径重复：urls.py里三个静态视图都用了空路径path('', ...)，Django只会匹配第一个符合条件的路径，导致index和about_us的URL规则完全无效，自然无法通过名称反向解析。
2. 站点地图类引用不匹配：urls.py导入的是DjangoModulesTestingApp，但sitemaps.py实际定义的是StaticSitemap，两者对不上。
3. 反向解析缺命名空间：因为urls.py设置了app_name = 'django_modules_testing_app'，反向解析视图名称时必须带上命名空间，否则Django找不到对应视图。

修复步骤 #

1. 修正URL路径冲突 #

修改urls.py，给每个静态视图分配唯一访问路径，同时修正站点地图类的引用：

from django.urls import path
from . import views
from . import blocks
from django.contrib.sitemaps.views import sitemap

# 替换成正确的站点地图类
from .sitemaps import StaticSitemap

app_name = 'django_modules_testing_app'

sitemaps = {
    'main_app': StaticSitemap  # 用正确的类名
}

urlpatterns = [
    path('', views.front_page, name='front_page'),
    path('index/', views.index, name='index'),  # 给index独立路径
    path('about-us/', views.about_us, name='about_us'),  # 给about_us独立路径

    path('category_details/<slug:slug>/', blocks.category_details, name='category_details'),
    path('search_website/', views.SearchWebsite.as_view(), name='search_website'),

    path('sitemap.xml', sitemap, {'sitemaps': sitemaps}, name='django.contrib.sitemaps.views.sitemap')
]

2. 完善站点地图的反向解析 #

修改sitemaps.py，在反向解析时带上app命名空间：

from django.contrib.sitemaps import Sitemap
from django.urls import reverse


class StaticSitemap(Sitemap): 
    changefreq = 'weekly'
    priority = 0.8
    protocol = 'http'
    app_name = 'django_modules_testing_app'  # 指定app命名空间

    def items(self):
        return ['front_page','index','about_us']  

    def location(self, item):
        # 拼接命名空间和视图名称进行反向解析
        return reverse(f'{self.app_name}:{item}')

3. 验证修复效果 #

重启Django服务，访问sitemap.xml查看静态页面链接是否正常生成，同时确认/index/和/about-us/页面能正常访问。

内容的提问来源于stack exchange，提问作者Arnold Schwartzkopf