使用django-excel-response 2.0.5无法正常导出Excel文件的问题排查

可能的原因及对应解决方法 #

1. DRF视图覆盖了响应头处理 #

如果你的视图继承自DRF的APIView或其子类，DRF默认会将响应处理为JSON格式，可能会覆盖ExcelResponse的Content-Type和Content-Disposition头，导致浏览器无法识别为下载文件。

解决办法：

• 改用普通Django视图（继承自django.views.generic.View或直接函数视图），而非DRF视图。
• 或者在DRF视图中手动构建响应，绕开DRF的默认响应处理：

from django.http import HttpResponse
import openpyxl
from io import BytesIO

def export_excel(request):
    sheet_data = [['a', 'b', 'c'], [1, 2, 3], [4, 5, 6], [7, 8, 9]]
    # 用openpyxl直接生成Excel文件
    wb = openpyxl.Workbook()
    ws = wb.active
    for row in sheet_data:
        ws.append(row)
    # 将文件写入内存流
    output = BytesIO()
    wb.save(output)
    output.seek(0)
    # 构建响应并设置正确的头信息
    response = HttpResponse(output, content_type='application/vnd.openxmlformats-officedocument.spreadsheetml.sheet')
    response['Content-Disposition'] = 'attachment; filename="test.xlsx"'
    return response

2. django-excel-response版本兼容性问题 #

django-excel-response 2.0.5的最后更新停留在2017年，可能与你当前使用的Django（3.x+）或DRF版本不兼容，导致响应头设置异常。

解决办法：

• 放弃使用django-excel-response，改用维护活跃的库（如openpyxl、xlsxwriter）配合Django原生HttpResponse实现导出，如上面的代码示例。
• 若坚持使用该库，尝试手动补全响应头：

response = ExcelResponse(sheet, 'test')
# 强制设置下载头和内容类型
response['Content-Disposition'] = 'attachment; filename="test.xlsx"'
response['Content-Type'] = 'application/vnd.openxmlformats-officedocument.spreadsheetml.sheet'
return response

3. 前端请求方式导致无法触发下载 #

如果是通过AJAX/fetch请求导出接口，浏览器默认不会自动触发文件下载弹窗，因为AJAX无法直接处理二进制文件的下载逻辑。

解决办法：
前端需要手动处理响应的二进制数据，将其转为Blob并创建下载链接：

fetch('/your-export-url/')
  .then(res => res.blob())
  .then(blob => {
    const url = window.URL.createObjectURL(blob);
    const a = document.createElement('a');
    a.href = url;
    a.download = 'test.xlsx';
    document.body.appendChild(a);
    a.click();
    window.URL.revokeObjectURL(url);
    document.body.removeChild(a);
  });

如果是直接在浏览器地址栏访问导出接口，可忽略此步骤，重点排查后端问题。

4. 检查响应头是否正确 #

打印后端返回的响应头，确认是否包含以下关键信息：

• Content-Type：application/vnd.openxmlformats-officedocument.spreadsheetml.sheet（针对xlsx格式）
• Content-Disposition：attachment; filename="test.xlsx"

若缺少这些头，浏览器无法识别为可下载文件，需手动补充。

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