Django自定义Admin下载CSV动作：如何同时实现下载与消息提示？

问题的核心在于：当Admin动作直接返回HttpResponse（下载响应）时，页面不会触发刷新，导致message_user添加的提示消息无法在Admin界面显示。要同时实现两个功能，需要通过重定向+专用下载视图的方式来处理：

步骤1：修改Admin动作逻辑 #

在Admin类中，调整动作方法，先添加提示消息，再将需要下载的数据标识存入Session，最后重定向到专门的下载视图：

from django.http import HttpResponseRedirect
from django.urls import reverse
from django.utils.translation import gettext_lazy as _

@admin.action(description=_("Download CSV"))
def download_csv(self, request, queryset):
    # 添加提示消息
    self.message_user(request, _("CSV文件开始下载"))
    # 将需要处理的对象ID存入Session（避免直接传递大数据）
    request.session['csv_download_ids'] = list(queryset.values_list('id', flat=True))
    # 重定向到自定义下载视图
    return HttpResponseRedirect(reverse('admin:custom_csv_download'))

步骤2：添加下载视图路由 #

在项目或应用的urls.py中，添加下载视图的路由（确保仅管理员可访问）：

from django.urls import path
from .views import admin_csv_download_view

urlpatterns = [
    # 其他Admin路由
    path('admin/custom-csv-download/', admin_csv_download_view, name='admin:custom_csv_download'),
]

步骤3：编写专用下载视图 #

在应用的views.py中，实现生成CSV并返回下载响应的逻辑，同时清理Session中的临时数据：

from django.contrib.admin.views.decorators import staff_member_required
from django.http import HttpResponse
from django.urls import reverse
import csv
import codecs
from .models import YourModel  # 替换为你的模型类
from django.utils.translation import gettext_lazy as _

@staff_member_required
def admin_csv_download_view(request):
    # 从Session获取需要处理的对象ID
    obj_ids = request.session.get('csv_download_ids', [])
    if not obj_ids:
        # 无数据时重定向回模型列表页
        return HttpResponseRedirect(reverse('admin:yourapp_yourmodel_changelist'))  # 替换为你的模型列表路由
    
    queryset = YourModel.objects.filter(id__in=obj_ids)
    
    # 生成CSV响应
    headers = {'Content-Disposition': 'attachment; filename="download.csv"'}
    response = HttpResponse(content_type='text/csv', headers=headers)
    response.write(codecs.BOM_UTF8)
    
    writer = csv.writer(response)
    # 写入表头（根据你的模型字段调整）
    writer.writerow(['字段1', '字段2', '字段3'])
    # 写入数据行
    for obj in queryset:
        writer.writerow([obj.field1, obj.field2, obj.field3])  # 替换为你的模型字段
    
    # 清理Session中的临时数据，避免重复下载
    del request.session['csv_download_ids']
    
    return response

原理说明 #

1. Admin动作仅负责添加提示消息和传递数据标识，然后触发页面重定向，此时Admin页面会刷新，提示消息会正常显示。
2. 重定向后的专用视图负责生成CSV文件并返回下载响应，确保浏览器触发下载行为。

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