如何在Django admin change view中实现数据下载功能？

核心思路：放弃前端逐字段采集数据的方案，改由后端直接读取当前模型实例的结构化数据生成Excel文件返回，开发成本和维护成本可降低90%以上

具体实现步骤 #

1. 微调现有模板代码 #

将下载按钮的name属性修改为自定义标识_download，避免和Django原生的提交动作冲突，修改后的模板片段如下：

{% extends 'admin/change_form.html' %}
{% load static %}
{% load i18n %}

{% block submit_buttons_bottom %}
    <div class="submit-row">
        <!-- 修改name为_download，作为后端识别下载动作的标识 -->
        <input type="submit" value="Download" id="download_profile" name="_download">
        <input type="submit" value="{% trans 'Save' %}" class="default" name="_save">
        <input type="submit" value="{% trans 'Save and add another' %}" name="_addanother">
        <input type="submit" value="{% trans 'Save and continue editing' %}" name="_continue">
    </div>
    <script src="{% static '/js/downloadData.js' %}"></script>
    <script src="{% static '/js/collapsibleSection.js' %}"></script>
    <script src="{% static '/js/investmentAdminScript.js' %}"></script>
{% endblock %}

注：此处保留按钮为submit类型，可复用Django Admin原生的表单校验、数据保存逻辑，满足「下载前先保存数据」的需求

2. 简化前端JS逻辑 #

不需要再遍历表单字段采集数据，仅保留确认弹窗逻辑即可：

'use strict';
window.addEventListener('load', () => {
    const downloadButton = document.querySelector('#download_profile');
    downloadButton.addEventListener('click', e => {
        if (!confirm('Data will be saved before downloading. Are you sure you want to continue?')) {
            e.preventDefault();
        }
    });
});

3. 后端添加下载处理逻辑 #

在对应模型的ModelAdmin类中，重写response_change方法，识别下载动作、生成Excel并返回文件响应即可，示例代码（依赖openpyxl库，可通过pip install openpyxl安装）：

from django.http import HttpResponse
from django.contrib import admin
from openpyxl import Workbook
from .models import YourModel # 替换为你自己的模型类

class YourModelAdmin(admin.ModelAdmin):
    # 你原来的其他配置，比如list_display、fieldsets等
    # ...

    def response_change(self, request, obj):
        # 识别下载动作
        if '_download' in request.POST:
            # 初始化Excel
            wb = Workbook()
            ws = wb.active
            ws.title = "数据详情"
            # 遍历模型字段写入Excel，自动适配所有字段，后续新增字段无需修改代码
            for field in obj._meta.fields:
                # 写入[字段中文名, 字段值]
                ws.append([field.verbose_name, str(getattr(obj, field.name))])
            # 配置响应头，触发浏览器下载
            response = HttpResponse(
                content_type='application/vnd.openxmlformats-officedocument.spreadsheetml.sheet'
            )
            response['Content-Disposition'] = f'attachment; filename="{obj}_数据详情.xlsx"'
            wb.save(response)
            return response
        # 非下载动作走原生逻辑
        return super().response_change(request, obj)

admin.site.register(YourModel, YourModelAdmin)

方案优势 #

• 完全不需要处理前端复杂的表单字段适配，下拉框、多对多、日期、富文本等特殊字段后端直接取模型值，准确率100%
• 后续模型新增/删除字段自动适配，不需要修改任何模板、JS代码，维护成本极低
• 复用Django Admin原生的权限校验、表单校验、数据保存逻辑，不需要额外开发配套功能

内容的提问来源于stack exchange，提问作者Prosy A.