django 警告 urls.W005 URL 命名空间不唯一

Question

我无法理解以下警告。我有一个名为“v1”的命名空间，我使用这些命名空间来确定 API 中的版本控制（使用 django Rest 框架）。所以，我有这样的路径：

/v1/accounts/me
/v1/listings

这是 URL 配置 (project/urls.py)：

urlpatterns = [
    path('admin/', admin.site.urls),
    path('v1/accounts/', include('accounts.urls', namespace='v1')),
    path('v1/listings/', include('listings.urls', namespace='v1'))
]

账户/urls.py

app_name = 'accounts'

urlpatterns = [
    url(r'^token/$', views.obtain_auth_token, name='obtain_token'),
    url(r'^me/$', my_account, name='my_account'),
]

清单/urls.py

app_name = 'listings'

urlpatterns = [
    path('', recent_listings, name='recent_listings')
]

一切都按预期进行。所有网址均已发送。版本控制有效。但是，我不断收到以下错误：

?: (urls.W005) URL 命名空间“v1”不是唯一的。您可能无法反转此命名空间中的所有 URL

我知道这是一个警告，我也许可以抑制它；但是，我想了解为什么会发生这种情况。根据我的 URLconf 和此警告，似乎不能有多个命名空间路径作为“兄弟”。它们需要是一个命名空间路径的子级（例如“v1”）。如果我的理解是正确的，我应该如何创建这个 URL 配置。

Answer 1

基本上发生的情况是，命名空间在反向查找 url 方面发挥着重要作用。例如：

在你的例子reverse('v1:obtain_token')中将返回/v1/accounts/token/. 假设您在accounts和中有两个同名的网址listings，那么您可能无法accounts在反向查询中找到网址。这就是警告的原因。如果为每个包含使用不同的名称空间会更好。在你的情况下，它应该是：

path('v1/accounts/', include('accounts.urls', namespace='accounts')),
path('v1/listings/', include('listings.urls', namespace='listings'))

请阅读文档以了解更多详细信息。

更新

你可以像这样进行版本控制：

path('accounts/', include('accounts.urls', namespace='accounts')),  # accounts url 

内部帐户应用程序：

path('v1/token/', views.obtain_auth_token, name='obtain_token_v1'),
path('v2/token/', views.obtain_auth_token2, name='obtain_token_v2'),
...