JavaScript 中 Ajax 怎么处理后端返回的二进制流文件

阿丽吖_1655

阿丽吖_1655

2026-07-31

228人浏览

原创

javascript中用ajax处理后端二进制流文件,需设responsetype为'blob',用blob构造文件对象并生成临时url下载,同时解析content-disposition获取文件名,注意跨域暴露头及内存释放。

javascript 中 ajax 怎么处理后端返回的二进制流文件

JavaScript 中用 Ajax 处理后端返回的二进制流文件,关键在于正确设置请求响应类型、接收原始字节数据,并用 Blob 构造可下载或可读取的文件对象。不能直接用 responseText 或默认的字符串解析方式,否则会损坏二进制内容。

设置 responseType 为 'blob'

Ajax 请求(包括 XMLHttpRequest 和 fetch)必须显式指定响应类型为 'blob',才能让浏览器以二进制形式接收响应体,避免自动编码转换:

JavaStoryDevelop
JavaStoryDevelop

你接手一个需求时,是不是经常这样:"改一个小字段 → 结果把不相关的代码也改了"、"需求说得很模糊 → 做着做着发现跑偏了"、"数据库加个字段 → 上线才发现漏了数据兼容"、"做了个新功能 → 一个月后自己都忘了当时怎么设计的"、"写到一半被中断 → 再回来不知道从哪继续";这个 Skill 就是专门解决这些问题的。 它会自动探测你的项目环境(JDK、Spring Boot、ORM、数据库、前端框架),记在

下载
  • XMLHttpRequest:在 open() 后、send() 前设置
    xhr.responseType = 'blob';
  • fetch:无需额外设置,但需确保服务端返回的是真实二进制流(如 Content-Type: application/octet-stream),且不加中间代理篡改响应体。

从响应中提取 Blob 并触发下载

拿到 Blob 后,可通过创建临时 URL 实现下载,或进一步读取内容(如图片预览、PDF 解析等):

  • 用 URL.createObjectURL(blob) 生成可访问的本地 URL;
  • 创建 <a></a> 标签,设置 href 为该 URL,download 属性指定文件名;
  • 调用 a.click() 触发浏览器下载;
  • 下载完成后建议调用 URL.revokeObjectURL(url) 释放内存。

处理服务端返回的文件名(可选但实用)

后端常通过响应头 Content-Disposition 携带原始文件名,例如:
Content-Disposition: attachment; filename="report.pdf"
JavaScript 可通过 response.headers.get('content-disposition')(fetch)或 xhr.getResponseHeader('content-disposition')(XHR)提取,并用正则解析出文件名:

  • 推荐正则:/filename[^;=\n]*=((['"]).*?\2|[^;\n]*)/i;
  • 注意对引号包裹的文件名做去引号处理(如 "my file.pdf" → my file.pdf);
  • 若无该 header,可 fallback 到后端约定的字段(如 JSON 包裹的 filename 字段),但此时需服务端返回 Content-Type: application/json,前端先解析再发起二次请求——不推荐,增加复杂度。

常见问题与避坑提示

实际开发中容易踩的坑:

  • 未设 responseType = 'blob',导致响应变成乱码字符串;
  • 跨域请求未配 Access-Control-Expose-Headers: Content-Disposition,无法读取自定义响应头;
  • 使用 axios 时忘记加 responseType: 'blob' 配置项;
  • 后端返回压缩(如 gzip)但未正确设置 Content-Encoding,浏览器可能解压失败或 Blob 内容异常;
  • 大文件下载时未考虑内存占用,长期保留 blob URL 可能引发内存泄漏。

Java免费学习笔记:立即使用
解锁 Java 大师之旅:从入门到精通的终极指南

相关专题

更多
python是前端还是后端
python是前端还是后端

Python属于前端也属于后端,其灵活性和丰富的生态系统使得开发人员能够在不同的领域中灵活运用。本专题为大家提供python相关的文章、下载、课程内容,供大家免费下载体验。

2023.08.11

2643

5

前端和后端的区别
前端和后端的区别

前端关注的是用户界面的设计和交互,而后端则注重数据处理和逻辑控制。想了解更多前端后端的相关内容,可以阅读本专题下面的文章。

2024.03.19

6730

13

后端的主要工作内容介绍
后端的主要工作内容介绍

后端是应用程序的服务端部分,负责核心任务,如数据库交互、业务逻辑处理和响应客户端请求。想了解更多后端的相关内容,可以阅读本专题下面的文章。

2024.03.19

6186

10

js获取数组长度的方法
js获取数组长度的方法

在js中,可以利用array对象的length属性来获取数组长度,该属性可设置或返回数组中元素的数目,只需要使用“array.length”语句即可返回表示数组对象的元素个数的数值,也就是长度值。php中文网还提供JavaScript数组的相关下载、相关课程等内容,供大家免费下载使用。

2023.06.20

5206

5

js刷新当前页面
js刷新当前页面

js刷新当前页面的方法:1、reload方法,该方法强迫浏览器刷新当前页面,语法为“location.reload([bForceGet]) ”;2、replace方法,该方法通过指定URL替换当前缓存在历史里(客户端)的项目,因此当使用replace方法之后,不能通过“前进”和“后退”来访问已经被替换的URL,语法为“location.replace(URL) ”。php中文网为大家带来了js刷新当前页面的相关知识、以及相关文章等内容

2023.07.04

1289

3

js四舍五入
js四舍五入

js四舍五入的方法:1、tofixed方法,可把 Number 四舍五入为指定小数位数的数字;2、round() 方法,可把一个数字舍入为最接近的整数。php中文网为大家带来了js四舍五入的相关知识、以及相关文章等内容

2023.07.04

5144

6

js删除节点的方法
js删除节点的方法

js删除节点的方法有:1、removeChild()方法,用于从父节点中移除指定的子节点,它需要两个参数,第一个参数是要删除的子节点,第二个参数是父节点;2、parentNode.removeChild()方法,可以直接通过父节点调用来删除子节点;3、remove()方法,可以直接删除节点,而无需指定父节点;4、innerHTML属性,用于删除节点的内容。

2023.09.01

980

4

JavaScript转义字符
JavaScript转义字符

JavaScript中的转义字符是反斜杠和引号,可以在字符串中表示特殊字符或改变字符的含义。本专题为大家提供转义字符相关的文章、下载、课程内容,供大家免费下载体验。

2023.09.04

1916

5

js生成随机数的方法
js生成随机数的方法

js生成随机数的方法有:1、使用random函数生成0-1之间的随机数;2、使用random函数和特定范围来生成随机整数;3、使用random函数和round函数生成0-99之间的随机整数;4、使用random函数和其他函数生成更复杂的随机数;5、使用random函数和其他函数生成范围内的随机小数;6、使用random函数和其他函数生成范围内的随机整数或小数。

2023.09.04

3645

4

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
WebStorm 官方调试文档
WebStorm 官方调试文档

共0课时 | 0人学习

React 教程
React 教程

共58课时 | 12.3万人学习

TypeScript 教程
TypeScript 教程

共19课时 | 6.7万人学习