如何通过Ajax接收Django返回的含CSV的HttpResponse实现文件下载
核心问题说明
浏览器仅对顶层导航请求(地址栏跳转、a标签点击、form提交、window.open打开的请求)收到的带Content-Disposition: attachment的响应自动触发下载。Ajax属于JS后台发起的异步请求,响应只会交由JS处理,浏览器不会自动触发下载,这是W3C规范定义的行为,并非代码逻辑错误。
另外你的现有代码存在几处直接导致运行失败的错误:
- 视图层拼写错误:
witer.writerow应为writer.writerow,否则会抛出NameError - 前端JS语法错误:
error: fucntion()的fucntion拼写错误,应为function;headers配置后多了一个分号,会导致JS解析失败 - jQuery参数不合法:
dataType: "text/csv"不是jQuery支持的合法值,该参数用于指定jQuery解析响应的格式,合法值为text、json、html等,传入非法值会直接触发Ajax错误回调
方案一:弃用Ajax,用原生GET请求触发下载(最推荐,适配你当前的GET导出场景)
你当前的导出逻辑为GET请求,完全不需要Ajax的异步处理,直接让浏览器发起顶层GET请求即可,带attachment标记的响应会自动触发下载,不会跳转当前页面,是最稳定的实现方式。
前端JS修改为:
$("#export").click(function(e){ e.preventDefault(); // 构造查询参数 const params = new URLSearchParams({ id_list: JSON.stringify(paperids), csrfmiddlewaretoken: '{{ csrf_token }}' }); // 触发浏览器导航,自动处理下载 window.location.href = `/export/?${params.toString()}`; })
如果担心URL长度限制或被浏览器拦截,可改用构造临时隐藏表单的方式提交,兼容性更好:
$("#export").click(function(e){ e.preventDefault(); // 创建临时GET表单 const form = document.createElement('form'); form.method = 'GET'; form.action = '/export/'; // 添加id_list参数 const idInput = document.createElement('input'); idInput.type = 'hidden'; idInput.name = 'id_list'; idInput.value = JSON.stringify(paperids); form.appendChild(idInput); // 添加CSRF参数 const csrfInput = document.createElement('input'); csrfInput.type = 'hidden'; csrfInput.name = 'csrfmiddlewaretoken'; csrfInput.value = '{{ csrf_token }}'; form.appendChild(csrfInput); // 提交表单触发下载 document.body.appendChild(form); form.submit(); // 清理临时DOM元素 document.body.removeChild(form); })
方案二:必须使用Ajax时的实现(适用于参数过长、需要前置校验等场景)
如果确实需要保留Ajax异步请求的逻辑,可以在回调中手动将拿到的CSV文本转为Blob文件对象,再触发浏览器下载。
修正后的前端代码:
$("#export").click(function(){ const data = { id_list: JSON.stringify(paperids), csrfmiddlewaretoken: '{{ csrf_token }}' }; $.ajax({ url: '/export/', type: 'GET', data: data, dataType: "text", // 改为合法的text类型,接收原始CSV文本 success: function(csvText){ // 将CSV文本转为Blob对象,指定MIME类型 const blob = new Blob([csvText], { type: 'text/csv;charset=utf-8;' }); const fileName = 'somefilename.csv'; // 与后端定义的文件名保持一致 // 兼容IE旧版本 if (window.navigator.msSaveOrOpenBlob) { window.navigator.msSaveOrOpenBlob(blob, fileName); return; } // 创建临时下载链接 const url = URL.createObjectURL(blob); const a = document.createElement('a'); a.href = url; a.download = fileName; a.style.display = 'none'; document.body.appendChild(a); // 触发点击下载 a.click(); // 清理临时资源 URL.revokeObjectURL(url); document.body.removeChild(a); }, error: function(xhr, status, error){ console.log("导出失败", error); } }) })
内容的提问来源于stack exchange,提问作者namespace-Pt
相关产品推荐
相关产品推荐

