uni-app无全局网络请求进度监听机制,因各端底层网络栈不暴露流式数据,uni.request仅支持终态回调;上传进度需用uni.createUploadTask,下载则须按端调用原生API。

uni-app 本身没有统一的「全局网络请求进度监听」机制,必须按平台分路径实现:H5 用 XMLHttpRequest 拦截,App 端靠 uni.uploadFile + uni.createUploadTask,小程序需用平台原生 API;直接对 uni.request 做进度监听是无效的。
为什么 uni.request 没有进度回调
uni.request 是封装层 API,底层在各端不暴露上传/下载流式数据,所以它只提供 success、fail、complete 三类终态回调,不支持中间进度。试图给它加 onProgressUpdate 或拦截 XMLHttpRequest.upload 在 App 和小程序里会静默失败。
- H5 环境下可手动替换全局
XMLHttpRequest,但会破坏其他库(如 axios)行为,不推荐用于复杂项目 - App 和小程序中,
uni.request的请求体走的是原生网络栈,无法注入进度钩子 - 文档里没写的,就别硬套——这不是遗漏,是跨端能力边界决定的
上传进度只能靠 uni.createUploadTask
这是目前唯一稳定、跨 App/iOS/Android 且无需原生插件的方案,但仅适用于文件上传场景(不是普通 GET/POST)。
- 必须用
uni.chooseImage/uni.chooseVideo等拿到本地临时路径后,再传给uni.createUploadTask - 不能把 base64 字符串当
filePath,会报错file system error - 返回的 task 对象有
onProgressUpdate回调,每秒触发 1–2 次,含progress(0–100 整数)、totalBytesWritten、totalBytesExpectedToWrite - 注意防 total 为 0:某些服务器不返回
Content-Length,此时progress可能恒为 0,得 fallback 到状态提示(如“正在发送…”)
下载进度在各端完全不兼容
想在 App 里显示下载进度条?别指望 uni.downloadFile 的 onProgressUpdate 能跨端工作——它只在 H5 生效。
- App 端必须用
plus.downloader.createDownload(依赖 5+ SDK),回调里有loaded和total,但 H5 和小程序完全不可用 - 微信小程序要用
wx.downloadFile+onProgressUpdate(基础库 ≥2.7.0),且仅真机有效,开发者工具不触发 - 支付宝、抖音等小程序平台各有自己的下载 API,uni-app 层无抽象,必须条件编译
- 别尝试用定时器读取临时文件大小:App 端沙箱路径不可见,
uni.getSavedFileList不包含未完成下载项
真正要监控「所有请求」进度?得换思路
业务上所谓“网络进度”,往往不是技术意义上的字节流,而是用户感知层面的等待状态。与其死磕底层,不如收敛到 UX 层控制:
- 所有关键请求前设 loading = true,成功/失败后设 loading = false,配合防抖避免闪动
- 上传任务单独管理,用
uni.createUploadTask+ 全局 map 存 task 实例,防止页面销毁后回调丢失上下文 - 下载任务按端拆:H5 用
fetch+ReadableStream,App 用plus.downloader,小程序各自原生 API - 最关键的一点:别把「网络请求中」和「进度条」强绑定。很多场景下,一个旋转图标 + 文案比假进度条更诚实
进度监听从来不是个纯技术问题——它卡在平台能力割裂、服务器响应不确定性、以及用户对“等待”的真实容忍阈值之间。写死一个通用进度条,不如先定义清楚:这个进度,到底是给谁看的?


















