微信小程序端uploadFile并发上限5–6个,超限会静默挂起或失败;App端无硬限但资源压力大;H5端受浏览器限制(通常6–8个)。应采用Promise队列控制并发数(推荐3),避免Promise.all全量提交,并注意tempFilePath过期及H5平台需传File实例。

uni.uploadFile并发太多会触发平台限制
微信小程序端默认最多同时维持5–6个活跃的 uploadFile 连接,超出后新请求会被静默挂起或直接失败;App端虽无硬性限制,但内存和带宽压力会明显上升;H5端则完全取决于浏览器并发策略(通常6–8个)。不加控制地用 Promise.all 或循环发起10个上传,大概率导致部分请求卡住、超时或报错 uploadFile:fail socket is closed。
用 Promise 队列 + 并发数控制最稳妥
别依赖 Promise.all 一次性扔全部,改用“固定窗口大小”的 Promise 队列。核心是:每次只让 N 个上传同时进行,前一个完成就补上下一个,保证活跃请求数始终 ≤ N。
- 推荐并发数设为
3:兼顾速度与稳定性,小程序、App、H5 三端都友好 - 用
async/await+for...of配合Promise.all分批处理,比手写递归更易读、易调试 - 每张图单独
try/catch,避免单张失败中断整个流程
async uploadBatch(filePaths, maxConcurrent = 3) {
const results = []
for (let i = 0; i < filePaths.length; i += maxConcurrent) {
const batch = filePaths.slice(i, i + maxConcurrent)
const batchPromises = batch.map((path, idx) =>
this.uploadSingleFile({ filePath: path, name: 'image', formData: { index: i + idx } })
.catch(err => ({ error: err, index: i + idx }))
)
const batchResults = await Promise.all(batchPromises)
results.push(...batchResults)
}
return results
}
uniCloud.uploadFile 也要同样节流
云函数调用 uniCloud.uploadFile 虽不走 socket,但频繁触发云函数实例创建仍可能被限频,尤其在阿里云函数冷启动场景下。而且每个 uniCloud.uploadFile 调用本身有执行时间开销(哪怕只是生成 fileID),并发过高容易触发 10 秒超时。
- 不要把所有
filePath塞进一个云函数里解析 multipart —— 云函数根本不支持自动拆多文件 - 前端必须逐个调用
uniCloud.callFunction,且同样按maxConcurrent = 3分批 - 注意
cloudPath必须带合法扩展名(如.jpg),否则腾讯云返回空fileID,看起来像“上传成功”实则没存
真机测试时最容易忽略的两个点
模拟器里跑得通,真机上出问题,往往卡在这两处:
-
tempFilePath30 秒过期:选图后不能延迟太久才上传,尤其是分批上传时,第二批可能已失效 —— 建议选完立刻开始,或用uni.getFileSystemManager().readFile提前转成 base64 缓存(仅小图) - H5 平台根本不用
filePath:必须改用files字段传File实例数组,且uni.uploadFile的参数结构完全不同,不加平台判断会直接报invalid file path


















