uni-app怎么处理接口返回的流文件

轻明姑娘_2497

轻明姑娘_2497

2026-11-03

711人浏览

原创

uni.request 请求流文件必须设 responseType: 'arraybuffer',否则会乱码或报错;小程序需 writeFile 写入临时文件再 openDocument,H5 用 Blob + createObjectURL。

uni-app怎么处理接口返回的流文件

uni.request 必须设 responseType: 'arraybuffer'

默认情况下 uni.request 把响应当文本或 JSON 解析,遇到 PDF、Excel、图片等流文件会直接乱码或报错 Failed to execute 'arrayBuffer' on 'Response': body stream is locked。这不是后端问题,是前端没告诉 UniApp “我要接的是二进制”。

必须显式设置 responseType: 'arraybuffer',否则 res.data 是字符串或空对象,后续所有转换都失效。

  • 不要写成 'blob' —— UniApp 不支持该值,会静默降级为 text
  • H5、微信小程序、App 三端都认 'arraybuffer',无需条件判断
  • 如果接口需要鉴权,header 中的 token 要照常传,不影响二进制接收

微信小程序预览流文件:用 writeFile + openDocument

小程序不支持 Blob 或 URL.createObjectURL,也不能直接用 base64 打开 PDF/Excel。唯一可靠路径是:把 ArrayBuffer 写入本地临时文件,再调 uni.openDocument。

关键点在于写入时的 encoding: 'binary' 和路径必须用 uni.env.USER_DATA_PATH:

  • filePath 必须带扩展名(如 .pdf),否则 openDocument 无法识别类型
  • data 字段直接填 res.data(即原始 ArrayBuffer),不要先转 base64 再转回来
  • uni.openDocument 的 fileType 参数可选填,但建议显式写上('pdf'、'xlsx')

H5 端可以直接用 URL.createObjectURL(new Blob([...]))

H5 浏览器支持 Blob 和 Object URL,比小程序灵活得多。但注意:不能直接把 ArrayBuffer 丢给 Blob 构造函数,要包一层数组。

uni-app
uni-app

uni-app 是基于 Vue 的跨端开发框架,适合开发 H5、App、小程序、鸿蒙和多端业务应用。

下载

正确写法是:new Blob([res.data], { type: 'application/pdf' }) —— 方括号不能少,否则报错 TypeError: Failed to construct 'Blob'。

  • type 值要尽量准确,PDF 用 'application/pdf',Excel 用 'application/vnd.openxmlformats-officedocument.spreadsheetml.sheet'
  • 生成的 URL 是临时的,页面刷新即失效,不用手动 revoke(除非长时驻留)
  • 别在 App 或小程序里套用这段代码,会直接报 Blob is not defined

大文件(>5MB)要避免 uni.arrayBufferToBase64

uni.arrayBufferToBase64 看起来方便,但它会把整个 ArrayBuffer 拷贝进字符串,内存占用翻倍,10MB 文件可能触发 iOS 小程序的内存警告甚至白屏。

真正需要 base64 的场景极少(比如内联图片 src)。绝大多数情况应绕过它:

  • 小程序:走 writeFile,跳过 base64 环节
  • H5:走 Blob + createObjectURL,也无需 base64
  • 只有在必须传 base64 给第三方 SDK 或服务时,才用它,且要加 loading 提示和失败兜底

流文件处理最易被忽略的一点:不同端的“临时文件”生命周期完全不同。小程序的 USER_DATA_PATH 文件能存到进程退出,而 H5 的 Blob URL 页面刷新就丢——别假设一次转换能跨端复用。

相关文章

PHP速学视频免费教程(入门到精通)
PHP速学视频免费教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

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

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

2023.08.11

2803

5

前端如何实现即时通讯
前端如何实现即时通讯

实现即时通讯的方法有WebSocket、Long Polling、Server-Sent Events、WebRTC等等。详细介绍:1、WebSocket,它可以在客户端和服务器之间建立持久连接,实现实时的双向通信,前端可以使用 WebSocket API来创建WebSocket连接,并通过发送和接收消息来实现即时通讯;2、Long Polling,是一种模拟实时通信的技术等等。

2023.10.09

6083

6

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

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

2024.03.19

7030

13

php和前端的关联介绍
php和前端的关联介绍

php既可以作为前端语言,也可以作为后端语言。想了解更多php和前端的相关内容,可以阅读本专题下面的文章。

2024.03.22

6818

10

前端外包工作内容有哪些
前端外包工作内容有哪些

前端外包工作内容包括:1. 网站和应用程序开发;2. 用户界面和交互设计;3. 用户体验优化;4. 设计和视觉开发;5. 跨浏览器兼容性;6. 性能优化;7. 维护和更新;8. 项目管理和沟通。想了解更多前端的相关内容,可以阅读本专题下面的文章。

2024.05.22

963

5

Tailwind CSS 如何制作导航栏和卡片
Tailwind CSS 如何制作导航栏和卡片

用 Tailwind CSS 制作导航栏和卡片,可先搭建语义化结构,再组合 Flex、Grid、间距、圆角与阴影类。这里整理横向导航、移动端菜单、卡片网格及悬停效果的相关文章,帮助你把常见页面组件做得清晰且适配不同屏幕。

2026.11.03

0

17

Tailwind CSS 响应式布局怎么写
Tailwind CSS 响应式布局怎么写

Tailwind CSS 响应式布局通常从移动端样式写起,再用 sm、md、lg 等前缀调整不同屏幕宽度下的网格、间距和导航。本专题整理断点配置、Grid 与 Flex 自适应布局及常见溢出问题,帮助你逐步完成多设备适配。

2026.11.03

0

19

Tailwind CSS 常用类名怎么记
Tailwind CSS 常用类名怎么记

Tailwind CSS 类名很多,先按布局、间距、文字、颜色和状态分组记忆,再通过官方文档检索具体写法。本专题结合类名排序、动态拼接失效、自定义实用类等问题,帮助你建立常用类名的速查方法。

2026.11.03

0

12

码上飞入口地址合集
码上飞入口地址合集

本专题汇总了码上飞(CodeFlying)的官方入口地址合集,涵盖官网主站及网页版在线使用入口,支持注册登录后直接在线体验零代码AI应用生成。同时整理了APP端下载渠道与小程序入口,助你快速访问平台,通过自然语言描述需求即可生成应用、小程序或网站。

2026.11.03

0

10

热门下载

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

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
uni-app从入门到实战教程
uni-app从入门到实战教程

共0课时 | 0人学习

uni-app x harmony开发指南
uni-app x harmony开发指南

共0课时 | 0人学习

uni-app鸿蒙运行和发行
uni-app鸿蒙运行和发行

共0课时 | 0人学习