You need to enable JavaScript to run this app. 如何使用Django CBV类视图实现带下载链接的模板及文件下载功能
优惠活动
大模型
产品
解决方案
定价
更多

如何使用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设计规范
    • 文件名带中文、特殊字符时容易出现编码错误

三、更优实现方案推荐

根据不同场景可以选择以下优化方案:

  1. 路径参数方案

把slug作为URL路径的一部分,路由配置为path('download/<slug:file_slug>/', views.FileDownloadView.as_view(), name='file_download')。Django原生支持slug类型的参数校验,URL更规范,也能避免大部分编码问题,适合大多数普通业务场景。

  1. ID映射方案

不在URL中传递文件名/文件slug,而是在数据库中存储文件的元数据(真实路径、展示名、权限、过期时间等),用文件的自增ID或者UUID作为下载参数。请求时通过ID查询数据库获取对应文件再返回,既完全隐藏了服务器真实文件路径,也可以方便扩展下载统计、权限校验等附加功能,是生产环境最常用的方案。

  1. 签名校验方案

面向外部用户的高风险下载场景,可以给下载链接加上签名和过期时间参数,后端校验签名合法且未过期才允许下载,能有效防止下载链接被恶意转发、滥用。


内容的提问来源于stack exchange,提问作者PaszaVonPomiot

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.10.09 01:06:03