Django下载模型上传的指定文件时返回HTML页面如何解决

问题根因 #

你的问题和filter查询无关，代码存在三处核心错误：

• 路由配置错误：两个路径的视图绑定对象、name属性、参数名全部不匹配，无法正确路由到getdata2函数
• 模板语法错误：Django模板调用路由的url标签缺少关键字，语法格式错误
• 视图返回值错误：当前getdata/getdata2均返回渲染后的HTML页面，没有返回文件流，所以下载内容为index.html

修复步骤 #

1. 修正路由配置 #

确保路由参数名、绑定视图、路由名三者对应：

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

urlpatterns = [
    # 绑定getdata视图，路由名设为getdata
    path('getdata/', views.getdata, name='getdata'),
    # 参数名和视图接收参数nameparam保持一致，绑定getdata2视图，路由名设为getdata2
    path('getdata2/<str:nameparam>/', views.getdata2, name='getdata2'),
]

2. 修正模板url标签语法 #

<!-- 第一个下载链接 -->
<a href="{% url 'getdata' %}" download>download1</a>
<!-- 第二个带书名参数的下载链接 -->
<a href="{% url 'getdata2' 'book1' %}" download>download2</a>

3. 重写视图函数返回文件流 #

替换原来返回render的逻辑，直接返回文件响应：

# views.py 新增依赖导入
from django.http import FileResponse, Http404
from django.conf import settings
import os

# 指定书名的下载视图
def getdata2(request, nameparam):
    # 查询对应书名的文件，取第一个匹配对象
    target_book = uploadFile.objects.filter(name=nameparam).first()
    if not target_book:
        raise Http404("请求的书籍文件不存在")
    # 拼接文件本地绝对路径
    file_full_path = os.path.join(settings.MEDIA_ROOT, target_book.file.name)
    # 构造文件响应
    response = FileResponse(open(file_full_path, 'rb'))
    # 设置响应头指定下载文件名
    response['Content-Disposition'] = f'attachment; filename="{target_book.name}"'
    return response

注意事项 #

• 确保settings.py中已正确配置MEDIA_ROOT和MEDIA_URL，否则无法定位文件存储路径
• 重名文件较多的场景建议用文件id而非书名作为查询参数，避免匹配错误
• 生产环境建议用Nginx代理媒体文件下载，不要通过Django处理文件响应，提升性能

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