如何使用Django CBV类视图实现带下载链接的模板及文件下载功能
基于Django CBV实现文件下载的方案
一、完整实现流程
你需要两个CBV配合实现需求:一个用TemplateView渲染带下载链接的列表页,另一个继承基础View处理下载请求,示例代码如下:
1. 视图代码
# views.py from django.views.generic import TemplateView, View from django.http import HttpResponse, FileResponse from django.conf import settings import os # 渲染文件列表页的TemplateView class FileListView(TemplateView): template_name = "file_list.html" def get_context_data(self, **kwargs): context = super().get_context_data(**kwargs) # 实际场景可从数据库读取文件元数据列表 context["file_list"] = [ {"display_name": "2024项目需求文档.pdf", "slug": "2024_project_req_v1"}, {"display_name": "接口说明文档.md", "slug": "api_doc_v2.3"} ] return context # 处理下载逻辑的视图 class FileDownloadView(View): def get(self, request): # GET参数取slug的写法 file_slug = request.GET.get("filename", "") # 若用路径参数,替换为 file_slug = kwargs.get("file_slug") # 必须加路径穿越防护,禁止读取指定目录外的文件 safe_dir = os.path.join(settings.MEDIA_ROOT, "public_download") target_file = os.path.abspath(os.path.join(safe_dir, file_slug)) if not target_file.startswith(safe_dir) or not os.path.isfile(target_file): return HttpResponse("文件不存在或无权限访问", status=404) # 返回下载响应 response = FileResponse(open(target_file, "rb")) # 配置响应头触发下载,display_name可从数据库读取对应展示名 response["Content-Disposition"] = f'attachment; filename="{file_slug}"' return response
2. 路由配置
# urls.py from django.urls import path from . import views urlpatterns = [ path("files/", views.FileListView.as_view(), name="file_list"), # GET参数方案路由 path("download/", views.FileDownloadView.as_view(), name="file_download"), # 路径参数方案路由(二选一即可) # path("download/<slug:file_slug>/", views.FileDownloadView.as_view(), name="file_download"), ]
3. 模板代码
<!-- templates/file_list.html --> <div class="file-list"> {% for file in file_list %} <p> <!-- GET参数方案链接 --> <a href="{% url 'file_download' %}?filename={{ file.slug }}" download>{{ file.display_name }}</a> <!-- 路径参数方案链接 --> <!-- <a href="{% url 'file_download' file.slug %}" download>{{ file.display_name }}</a> --> </p> {% endfor %} </div>
二、文件名slug作为GET参数的合理性评估
这个方案属于能用但适用场景有限的实现:
- 优势:
- 实现成本极低,不需要修改路由规则,动态传参灵活
- 适合内部工具、低风险的小流量场景
- 缺陷:
- 安全性差,未做防护的情况下容易被攻击者枚举slug批量爬取所有文件
- URL不美观,不符合RESTful设计规范
- 文件名带中文、特殊字符时容易出现编码错误
三、更优实现方案推荐
根据不同场景可以选择以下优化方案:
- 路径参数方案
把slug作为URL路径的一部分,路由配置为
path('download/<slug:file_slug>/', views.FileDownloadView.as_view(), name='file_download')。Django原生支持slug类型的参数校验,URL更规范,也能避免大部分编码问题,适合大多数普通业务场景。
- ID映射方案
不在URL中传递文件名/文件slug,而是在数据库中存储文件的元数据(真实路径、展示名、权限、过期时间等),用文件的自增ID或者UUID作为下载参数。请求时通过ID查询数据库获取对应文件再返回,既完全隐藏了服务器真实文件路径,也可以方便扩展下载统计、权限校验等附加功能,是生产环境最常用的方案。
- 签名校验方案
面向外部用户的高风险下载场景,可以给下载链接加上签名和过期时间参数,后端校验签名合法且未过期才允许下载,能有效防止下载链接被恶意转发、滥用。
内容的提问来源于stack exchange,提问作者PaszaVonPomiot
相关产品推荐
相关产品推荐

