Django中使用模板{% url %}标签向视图传递参数时出现NoReverseMatch错误的解决方法

这个问题我之前也碰到过！核心原因很简单——你定义的URL里用了<str:fpath>，但Django的str路径转换器默认是不匹配带斜杠（/）的字符串的，它对应的正则是[^/]+，意思是只能抓连续的非斜杠字符。而你传的lms/static/lms/files/homework/Math 1/3/3里有好几个斜杠，自然就和URL模式对不上，触发NoReverseMatch错误了。

下面给你两种靠谱的解决办法：

方法一：改用path路径转换器 #

Django内置了专门用来匹配含斜杠路径的转换器path，直接替换原来的str就行，修改你的URL配置：

path('download/<path:fpath>/<str:fname>', views.download, name='download')

改完之后，模板里的<a>标签不用做任何修改，原来的写法就能正常生成URL了，因为path转换器会匹配从download/之后到下一个斜杠前的所有内容（包括中间的斜杠），直到最后捕获fname参数。

方法二：用正则表达式自定义匹配规则 #

如果你更习惯用正则来控制匹配逻辑，可以改用re_path（也就是Django 1.x里的url函数），手动写正则表达式来匹配含斜杠的fpath：

from django.urls import re_path

re_path(r'^download/(?P<fpath>.+)/(?P<fname>[^/]+)$', views.download, name='download')

这里的.+会匹配任意字符（包括斜杠），直到遇到最后一个斜杠后面的fname（因为fname的正则[^/]+会匹配到URL结尾的文件名），同样能解决你的问题。

重要提醒 #

不管用哪种方法，一定要注意路径安全！不要直接用用户传入的fpath去读取服务器上的文件，很容易引发路径遍历攻击。比如你可以先把fpath转换成绝对路径，然后检查它是否在你允许的目录范围内，举个简单的例子：

import os
from django.conf import settings
from django.http import HttpResponseForbidden

def download(request, fpath, fname):
    # 限制文件只能在指定的静态文件目录下
    allowed_dir = os.path.join(settings.BASE_DIR, 'lms/static/lms/files')
    full_path = os.path.join(allowed_dir, fpath, fname)
    # 检查路径是否在允许的目录内
    if not os.path.abspath(full_path).startswith(os.path.abspath(allowed_dir)):
        # 返回403或者错误提示
        return HttpResponseForbidden("Access denied")
    # 后续的文件下载逻辑...

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