Django教程报错urls.W005：URL命名空间‘polls’不唯一如何解决？

嘿，这个问题我帮不少开发者排查过，咱们一步步来揪出问题所在～

这个错误的核心是：Django检测到命名空间polls被重复注册了，哪怕你换了名字还是报错，说明你可能没找到重复注册的根源，下面是最常见的几种操作失误：

1. 根urls.py里重复include了同一个应用的URL配置 #

你可能在复制教程代码的时候，不小心重复粘贴了include语句，比如根urls.py里出现了两行一模一样的配置：

urlpatterns = [
    path('admin/', admin.site.urls),
    path('polls/', include('polls.urls', namespace='polls')),
    path('polls/', include('polls.urls', namespace='polls'))  # 这里就是重复的罪魁祸首！
]

这种情况很容易被忽略，仔细检查一下根urls.py里的内容，删掉重复的那一行就行。

2. 应用urls.py的app_name和根urls的namespace重复设置 #

Django里有两种指定命名空间的方式，不要同时用：

• 如果你在polls/urls.py里已经设置了app_name：

  app_name = 'polls'  # 这里已经定义了应用的命名空间
  urlpatterns = [
      # 你的URL路径配置
  ]
  

  那根urls.py里include的时候，就不能再加namespace='polls'，否则就会重复注册同一个命名空间。正确的写法应该是：

  path('polls/', include('polls.urls'))
  

3. 其他应用的app_name和polls重复 #

如果你还创建了其他Django应用，不小心把某个应用的app_name也设成了polls，这也会触发这个错误。检查所有应用的urls.py，确保每个应用的app_name都是唯一的。

快速排查步骤 #

1. 先打开根urls.py，确认没有重复的include('polls.urls', namespace='polls')语句；
2. 打开polls/urls.py，如果有app_name = 'polls'，就把根urls里的namespace='polls'删掉；
3. 检查所有应用的urls.py，确保没有其他应用用了相同的命名空间名称。

如果做完这些还是报错，可以把你的根urls.py和polls/urls.py的代码贴出来，我能帮你更精准地定位问题～

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