unicloud.uploadfile 一次只能上传一个文件，不支持数组参数；批量上传应采用客户端直传+云函数仅处理元数据的方案，避免云函数超时与内存风险。
uniCloud.uploadFile 不支持直接传多个文件
直接调用 uniCloud.uploadFile 一次只能上传一个文件，它没有 files 数组参数——这和 uni.uploadFile 的多文件上传机制完全不同。很多人误以为云函数里也能像前端那样传 files: [{...}, {...}]，结果报错或静默失败。
真正可行的方式只有两种：循环调用 uniCloud.uploadFile，或让客户端直传（推荐）。云函数本身不持有临时文件路径，所以「先收多个 base64 / 二进制 → 再统一上传」这条路在 uniCloud 里走不通，除非你手动拼 buffer 并确保格式正确（风险高、兼容差）。
-
uniCloud.uploadFile的fileContent参数只接受Buffer（阿里云）或本地绝对路径（腾讯云），不接受数组 - 若从 HTTP 请求中拿到多个 base64 字符串，必须逐个
Buffer.from(x, 'base64')，再分别调用uniCloud.uploadFile - 云函数超时默认 10 秒，上传 5 张图大概耗时 2–4 秒；超过 10 张建议拆成并发 Promise.all，但要控制数量（如
Promise.all(files.slice(0, 3).map(...))）
客户端直传才是批量上传的正解
uni-app 多图批量上传，应该让每个 tempFilePath 都走一次 uniCloud.uploadFile，而不是塞进一个云函数里中转。这样既绕过云函数执行时间限制，又避免 base64 解码开销和内存溢出风险。
关键点在于：前端生成合法 cloudPath，并确保每个文件都独立调用。失败可重试单个，不影响整体。
- 选图后拿到
res.tempFilePaths，遍历调用uniCloud.uploadFile({ filePath: item, cloudPath: `img/${Date.now()}-${Math.random().toString(36).substr(2,6)}.jpg` }) -
filePath必须是字符串类型，且未过期（30 秒内）；cloudPath必须带扩展名，否则腾讯云返回空fileID - 不要用中文、空格、特殊符号命名
cloudPath，CDN 会 404 - 并发上传建议加节流（如每次最多 3 个），避免小程序端触发频率限制
云函数只做元数据处理，别碰原始文件
如果你坚持要用云函数介入批量流程，它的角色只能是「校验 + 记录 + 回调」，而不是「搬运工」。比如检查图片尺寸、调用 uniCloud.contentSecurity.imageModeration 鉴黄、写入数据库记录 fileID 列表。
上传动作仍由客户端完成，云函数收到的是已上传成功的 fileID 数组，不是原始文件。
- 客户端上传成功后，再发一次请求给云函数，携带
[fileID1, fileID2, ...]和业务字段（如postId） - 云函数用
db.collection('images').add({ fileIds: event.fileIds, postId: event.postId })存元数据 - 想生成缩略图？在云函数里用
canvas或sharp模块处理 —— 但输入必须是服务端生成的图，不能读取客户端tempFilePath
微信小程序不支持多文件并发？那是误解
微信小程序 API 确实不支持 uni.uploadFile 的 files 数组参数，但它完全支持并发调用多次 uni.uploadFile。所谓「不支持」其实是早期文档误导，现在只要控制好并发数（≤5），成功率很高。
H5 和 App 端更无此限制，uni.uploadFile 多次调用与原生 XMLHttpRequest 并发一致。
- 不要用递归串行上传（容易卡死、超时），改用
Promise.allSettled(filePaths.map(uploadOne)) - 每个
uploadOne函数内部应包含重试逻辑（如失败时延迟 500ms 后再试一次） - 上传前务必校验
tempFilePath是否存在：if (!item || typeof item !== 'string') return Promise.reject('invalid tempFilePath')
