Django调用reverse()传视图额外参数时触发NoReverseMatch报错

核心错误原因 #

path() 第三个位置传入的字典参数，是路由匹配完成后固定传给视图函数的静态额外选项，不属于URL路径的动态占位匹配段，反向解析阶段不会被识别为合法的路径参数。

具体遗漏点说明 #

• 你当前配置的路由实际匹配规则只有items/<int:item_id>，路径层面仅接收item_id这一个动态段，和报错提示中尝试匹配的正则规则items/(?P<item_id>[0-9]+)\Z完全对应，路由规则里根本没有message的参数位置。
• reverse()的kwargs入参，只接受路由路径中通过<>语法定义的动态占位符对应值，任何不在路径占位符列表里的键值对传入后，都会直接触发NoReverseMatch，框架无法为不存在的路径段拼接URL。
• 你参照的「向视图函数传递额外选项」能力，作用范围是正向请求匹配到路由之后的参数注入阶段，不参与反向解析的URL生成逻辑，且该字典里的值是路由层面静态绑定的，无法通过reverse()动态修改。

对应修正方案 #

根据实际业务需求二选一即可：

1. 需要把message放在URL路径中传递
   直接修改路由规则，给message增加路径占位符，去掉原来的静态额外参数字典：

   from django.urls import path
   from . import views
   
   urlpatterns = [
       # 其余路由不变
       path("items/<int:item_id>/<str:message>", views.item_page, name="item page")
   ]
   

   这时候原有reverse写法可以正常运行。
2. 不需要把message暴露在URL路径中
   不要试图通过reverse传该参数，反向解析时仅传入item_id生成基础路径，message通过查询参数、session、Django消息框架等方式传递。如果用查询参数的写法参考如下：

   from django.urls import reverse
   from django.http import HttpResponseRedirect
   from urllib.parse import urlencode
   
   base_path = reverse("item page", kwargs={'item_id': item_id})
   reversed_url = f"{base_path}?{urlencode({'message': 'hello'})}"
   return HttpResponseRedirect(reversed_url)
   

   如果要沿用静态额外选项的特性，直接在路由字典里写死需要的值即可，该值会在请求进入视图时作为关键字参数传入，不需要在reverse时传递。

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