tempFilePath仅当前生命周期有效，页面跳转或App切后台后易被清理，必须先用uni.saveFile持久化再使用savedFilePath，不可直接用于uni.openDocument等API。
uni.downloadFile 返回的 tempFilePath 不能直接用
临时路径只在当前生命周期内有效，页面跳转、App 切后台、甚至某些 Android 厂商系统清理内存时，tempFilePath 指向的文件可能已被删除。直接拿它去调 uni.openDocument 或传给其他 API，大概率报错 fail file not found。
必须走完整流程：下载 → 保存 → 使用保存后的路径。中间不能跳步，也不能复用 tempFilePath 做后续操作。
- 务必在
uni.downloadFile的success回调里判断res.statusCode === 200，否则可能拿到 304/404 等响应却误以为下载成功 -
tempFilePath是相对路径（如tmp_123456.pdf），而uni.saveFile要求传入的是完整临时路径（即res.tempFilePath字符串本身） - 不要对
tempFilePath做字符串截断、拼接或后缀补全——它的内容不可信，后缀应以响应头Content-Type或Content-Disposition为准
uni.saveFile 保存的路径用户根本找不到
uni.saveFile 默认把文件写进应用私有目录，比如 Android 上是 /Android/data/io.dcloud.HBuilder/apps/HBuilder/doc/uniapp_save/xxx.pdf。这个路径普通用户无法通过“文件管理器”直接访问，也不在系统 Downloads 目录里。
想让用户真正“看到”文件，得绕过 uni.saveFile 的默认行为：
- iOS 可用
plus.io.resolveLocalFileSystemURL+entry.moveTo把文件移进documents目录，确保出现在“文件”App 中 - Android 10+（API 29）必须启用
android:requestLegacyExternalStorage="true"并动态申请WRITE_EXTERNAL_STORAGE权限，再用plus.downloader.createDownload指定绝对路径（如file:///storage/emulated/0/Download/xxx.pdf） - 若不想处理原生权限，最低兼容方案：用
uni.getFileSystemManager().moveFile把savedFilePath移到uni.env.USER_DATA_PATH下，再调uni.showActionSheet提示用户“前往应用私有目录查找”
uni.openDocument 打不开？先看平台和路径类型
uni.openDocument 在 H5 端完全不支持，调用会静默失败；在 App 端则严格要求传入**绝对路径**，且该路径必须可读、有正确后缀、文件真实存在。
常见错误链：uni.downloadFile → 直接传 res.tempFilePath 给 uni.openDocument → 找不到文件。
- 必须等
uni.saveFile成功回调里的res.savedFilePath，这才是稳定可用的路径 - Android 上若后端返回无后缀响应（如
Content-Type: application/pdf但没filename），savedFilePath可能缺扩展名，需手动补：例如res.savedFilePath + '.pdf' - iOS 不支持直接打开非图片/视频的二进制流文件，必须先
uni.saveFile再uni.openDocument，不能跳过保存步骤 - 调用前建议用
uni.getFileSystemManager().accessSync检查路径是否可读，避免黑屏或无响应
大文件或批量下载别硬扛
uni.downloadFile 是内存加载模式，下载过程中整个文件会先载入内存再写入临时目录。几百 MB 的 PDF 或 Excel 极易触发内存溢出，尤其低端 Android 机型。
真要支持大文件或并发下载，得换路子：
- 优先用
plus.downloader：支持断点续传、进度监听、直接写入指定路径，不经过 JS 层内存中转 - 批量下载必须串行控制：用
async/await或Promise.allSettled配合重试逻辑，避免多个uni.downloadFile同时争抢临时目录空间 - 下载前先
uni.downloadFileHEAD 请求，校验Content-Length和Content-Type，超限（如 >50MB）就提示用户“文件过大，建议用电脑端下载”
真正卡住人的从来不是 API 调不通，而是路径在哪儿、权限有没有、文件到底存没存进去——这些细节不会报错，只会让功能“看起来正常，实际找不到”。
