Django报错Reverse for 'download_excel/309' not found排查

触发Reverse for 'download_excel/309' not found. 'download_excel/309' is not a valid view function or pattern name错误的核心原因是模板中{% url %}标签语法使用错误：你将URL路径参数直接拼接在了路由名称字符串内，Django反向解析时会把整个download_excel/309作为路由名去匹配已注册的路由规则，自然找不到对应项。
手动访问目标URL能正常触发下载，是因为直接请求走的是正向路由匹配逻辑，不涉及反向解析流程，因此视图本身的下载逻辑没有问题。

1. 修正模板内url标签写法 #

Django模板的{% url %}标签语法规则为：第一个传入参数是命名空间:路由name值，路由需要的路径/查询参数作为后续独立参数传入，不能直接拼在路由名字符串后面。
将index.html中的超链接代码修改为如下内容即可解决反向解析错误：

<a href="{% url 'polls:download_excel' 309 %}">Download State Impulsivity Excel</a>

如果study参数是模板渲染时传入的动态值（比如列表循环中的业务ID），直接传入对应模板变量即可：

<!-- 动态传参示例，study为模板上下文中的变量 -->
<a href="{% url 'polls:download_excel' study %}">Download State Impulsivity Excel</a>

标签使用的核心注意点：

• 标签第一个参数永远对应urls.py中path()配置的name属性，加了app_name的情况下要带上命名空间前缀
• 路由定义的位置参数按定义顺序依次传入即可，也支持关键字参数写法：{% url 'polls:download_excel' study=309 %}，效果完全一致

2. 路由配置优化（可选，推荐） #

当前路由路径结尾未添加斜杠，Django默认开启的APPEND_SLASH配置会对不带尾斜杠的请求做301重定向，建议给路由补充尾斜杠，减少不必要的重定向开销：

# urls.py
from django.urls import path
from . import views

app_name = 'polls'
urlpatterns = [
    path('Excel/<int:study>/', views.Excel, name='Excel'),
    path('download_excel/<int:study>/', views.download_excel, name='download_excel'),
]

修改路由后不需要调整模板内的url标签写法，Django反向解析时会自动补全尾斜杠。

额外提醒：当前视图代码中content_type传参存在隐患，mimetypes.guess_type(filename)返回值是(文件MIME类型, 编码格式)的元组，直接传入HttpResponse会导致响应头异常。可以直接指定Excel文件的MIME类型：content_type='application/vnd.openxmlformats-officedocument.spreadsheetml.sheet'，或者取元组第一个值：mimetypes.guess_type(filename)[0]。

修改完成后模板即可正常加载，点击超链接会正确跳转到下载地址，触发文件下载逻辑。

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