Promise 本身不支持上传进度监听，需结合 XMLHttpRequest 封装并监听 xhr.upload.onprogress 事件实时通知进度，Fetch 原生不支持，可降级 XHR 或用流式库间接实现。
Promise 本身不支持上传进度监听，因为它只表示异步操作的最终成功或失败，不提供中间状态（比如进度百分比）。要处理文件上传进度，必须结合 XMLHttpRequest 或 Fetch API + Upload Stream（实验性），再用 Promise 封装结果，同时通过事件机制（如 upload.onprogress）暴露进度信息。
用 XMLHttpRequest 封装带进度的 Promise
这是最成熟、兼容性最好的方式。核心是：创建 XHR 实例 → 监听 upload.onprogress → 在 Promise 外部触发进度回调 → 成功后 resolve，失败时 reject。
- 不能直接在 Promise 构造函数里写
onprogress，因为 Promise 一旦 resolve/reject 就不可变；进度需通过外部函数（如onProgress）实时通知调用方 - 注意设置
xhr.upload.onprogress（不是xhr.onprogress），否则监听的是下载进度 - 进度计算公式：
Math.round((e.loaded / e.total) * 100)，e.total可能为 0（如 CORS 未暴露Content-Length），需做安全判断
Fetch 不支持原生上传进度（但可间接实现）
标准 Fetch API 没有上传进度事件。可行方案有两种：
Alibabacloud Sdk Client Initialization For Java
下载
在 Java 中初始化和管理阿里云 SDK客户端。包括单例模式、线程安全、endpoint 与 region 配置、VPC 终端节点、同步与异步等。
-
使用第三方流式库（如
form-data+ReadableStream）：手动构造 multipart body，边读取文件边推送 chunk，并在每个 chunk 发送后更新进度（适合现代环境，需 polyfill） - 降级回 XHR：对需要进度的上传，不使用 fetch，统一走 XHR 封装，避免兼容性风险
- 部分浏览器（如 Chrome）支持
AbortSignal中断上传，但和进度无关，仅用于取消
封装一个可监听进度的 upload 函数
推荐封装成返回 Promise 的函数，并接受 onProgress 回调：
立即学习“Java免费学习笔记（深入）”；
- 函数签名类似：
uploadFile(file, url, { onProgress }) - 内部创建 XHR，绑定
upload.onprogress，调用onProgress({ loaded, total, percent }) - 成功时 resolve 响应数据（如 JSON），失败时 reject 错误对象（含 status、message）
- 可扩展支持多个文件、取消 token、headers 设置等，但进度逻辑始终依赖 XHR 事件
常见坑与注意事项
实际开发中容易忽略的关键点：
- CORS 配置必须包含
Access-Control-Allow-Headers: Content-Length，否则e.total为 0，无法计算准确进度 - 大文件分片上传更适合控制进度和断点续传，此时“整体进度”需由业务层聚合各分片完成比例
- 不要在
onprogress里频繁 setState（React）或触发 DOM 更新，建议节流（如每 1% 更新一次） - 移动端 WebView 对 XHR 进度事件支持较好，但部分旧版 iOS Safari 可能有延迟，建议 fallback 显示“上传中…”文字
