Django网站点击链接下载文件功能失效求助

核心问题 #

你当前的链接直接指向文件名（<a href="{{ file }}">{{ file }}</a>），浏览器会直接尝试打开文件而非触发下载——因为请求没有经过视图中处理下载的逻辑（设置Content-Disposition: attachment响应头）。

具体修复步骤 #

1. 修正HTML模板中的链接

将链接改为指向print_ip视图并传递文件名参数。假设你在urls.py中给该视图设置的名称是print_ip，修改模板代码：

{% for file in files %}
    <p><a href="{% url 'print_ip' filename=file %}">{{ file }}</a></p>
{% endfor %}

2. 配置正确的URL路由

确保urls.py中包含两种路由：一种用于展示文件列表，一种用于处理下载请求：

from django.urls import path
from . import views

urlpatterns = [
    path('print-ip/', views.print_ip, name='print_ip'),
    path('print-ip/<str:filename>/', views.print_ip, name='print_ip'),
]

3. 优化视图中的文件操作

• 用os.path.join拼接路径，避免硬编码导致的路径错误
• 使用with语句自动关闭文件，防止资源泄漏
• 推荐用FileResponse替代HttpResponse，更适配文件下载场景
  修改后的视图代码：

import os
import mimetypes
from django.conf import settings
from django.http import FileResponse
from django.shortcuts import render

def print_ip(request, filename=''):
    if request.method == "POST":
        get_ipfile(request)

    file_dir = os.path.join(settings.BASE_DIR, "mysite", "ip_print_files")
    ip_files_list = os.listdir(file_dir)

    if filename != '':
        filepath = os.path.join(file_dir, filename)
        # 安全检查：防止路径遍历攻击，确保请求的文件在指定目录内
        if not os.path.isfile(filepath) or not filepath.startswith(file_dir):
            return render(request, "print_ip.html", {"files": ip_files_list, "error": "文件不存在"})
        
        mime_type, _ = mimetypes.guess_type(filepath)
        response = FileResponse(open(filepath, 'rb'), content_type=mime_type)
        response['Content-Disposition'] = f"attachment; filename={filename}"
        # 若文件名含中文/特殊字符，用以下方式处理编码
        # from urllib.parse import quote
        # response['Content-Disposition'] = f"attachment; filename*=UTF-8''{quote(filename)}"
        return response
    else:
        return render(request, "print_ip.html", {"files": ip_files_list})

4. 额外安全提示

• 必须保留文件存在性与路径合法性检查，防止攻击者通过构造特殊文件名访问服务器敏感文件
• 若文件名包含中文或特殊字符，需对文件名做URL编码，避免下载时出现文件名乱码

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