uni-app如何实现App端文件预览 uni-app使用openDocument-uni-app-PHP中文网

uni.opendocument在app端仅支持本地文件路径，不接受网络url或file://等非标准路径；必须通过uni.downloadfile下载后，用res.tempfilepath或uni.savefile生成的savedfilepath调用，且需校验statuscode为200。

uni-app如何实现app端文件预览 uni-app使用opendocument

uni.openDocument 在 App 端能直接打开 PDF、Office 等常见文档，但仅限于已下载到本地的文件路径——它不接受网络 URL，也不支持 file:// 或 __UNI__ 这类非标准协议路径。用错路径格式是 90% 的“打开失败”根源。

为什么 `uni.openDocument` 调用后没反应或报错 “filePath is not valid”

App 端对 filePath 校验极严，常见失效路径包括：

__UNI__xxx.pdf：H5 可用，App 端完全无法识别
file:///var/mobile/.../temp.pdf（iOS）或 file:///data/user/.../temp.pdf（Android）：系统拒绝加载，openDocument 不支持 file:// 协议
http:// 或 https:// 链接：直接传 URL 会静默失败，无提示
未等 uni.downloadFile 完全成功就调用：res.tempFilePath 为空或未生成

真正有效的路径只有两类：res.tempFilePath（临时路径，生命周期短）或 uni.saveFile 后返回的 savedFilePath（持久路径，推荐）。

如何确保 `uni.openDocument` 在 iOS/Android 上都稳定触发

关键不是“怎么调”，而是“怎么准备路径”。必须走完整下载 → 校验 → 打开链路：

uni-app

uni-app 是基于 Vue 的跨端开发框架，适合开发 H5、App、小程序、鸿蒙和多端业务应用。

下载

务必检查 res.statusCode === 200，不能只看 success 回调
下载完成后立即调用 uni.saveFile，把临时文件固化为持久路径（尤其 iOS 对临时文件清理更激进）
fileType 参数可填可不填，但填对能提升部分 Android 厂商机型的兼容性（如 'pdf'、'docx'）
iOS 上若仍失败，需确认 NSAppTransportSecurity 已允许 HTTP（如果源地址是 http）

示例片段：

uni.downloadFile({
  url: 'https://api.example.com/file.pdf',
  header: { 'Authorization': 'Bearer xxx' },
  success: (res) => {
    if (res.statusCode === 200) {
      uni.saveFile({
        tempFilePath: res.tempFilePath,
        success: (saveRes) => {
          uni.openDocument({
            filePath: saveRes.savedFilePath,
            fileType: 'pdf',
            success: () => console.log('已打开'),
            fail: (err) => console.error('open fail', err)
          });
        }
      });
    }
  }
});