uni.openDocument打不开PDF的主因是路径或协议不合规：仅支持本地临时路径或static/包内路径，不支持HTTP链接；网络PDF须先uni.downloadFile下载再传tempFilePath，且安卓需带.pdf后缀、iOS需用res.tempFilePath字段。
uni-app里用uni.openDocument打开PDF失败的常见原因
直接调用uni.openDocument打不开PDF，大概率不是代码写错了，而是文件路径或协议没过校验。这个API只接受本地临时路径（tempFilePath）或应用包内路径（static/下），不支持直接传HTTP链接——哪怕链接能被浏览器打开也不行。
- 网络PDF必须先用
uni.downloadFile下载到本地临时路径，再传给uni.openDocument - 安卓端对文件后缀敏感，
filePath必须带.pdf扩展名，否则可能提示“文件格式不支持” - iOS真机上，如果PDF是从
uni.downloadFile下载的，但没指定success回调里的tempFilePath，而是用了res.tempFilePath以外的字段（比如误用res.filePath），会静默失败
uni-app中PDF预览的完整流程：下载 + 打开
没有一步到位的方法，必须拆成两步：先下载，再打开。尤其在微信小程序环境，uni.openDocument是唯一合规方案；H5端则需降级为<iframe>或window.open，不能依赖同一套逻辑。
- 下载时务必检查
statusCode === 200，避免把404响应体当PDF保存 - 下载成功后，立即调用
uni.openDocument，不要做异步延迟（如setTimeout），部分安卓机型会因路径失效而报错fail file not found - H5端需单独判断：
uni.getSystemInfoSync().platform === 'h5'，然后用<iframe src="xxx.pdf">嵌入，或新开窗口window.open(url)（注意跨域）
uni.downloadFile({
url: 'https://example.com/file.pdf',
success: (res) => {
if (res.statusCode === 200) {
uni.openDocument({
filePath: res.tempFilePath,
success: () => console.log('PDF打开成功'),
fail: (err) => console.error('打开失败', err)
});
}
}
});
uni-app中PDF附件预览的兼容性陷阱
不同平台对PDF的支持粒度差异很大：微信小程序强制走uni.openDocument，App端（iOS/Android）底层调用系统阅读器，H5端完全依赖浏览器能力——这意味着你没法靠一个API覆盖所有场景，必须按平台分流处理。
- App端若PDF过大（比如>50MB），
uni.downloadFile可能超时或内存溢出，建议加timeout: 60000并提示用户“文件较大，请稍候” - 微信小程序里，
uni.openDocument打开后无法监听关闭事件，也不能控制页面跳转，属于纯外部跳转行为 - H5端如果PDF链接跨域，
iframe会白屏且无报错，需服务端配置Access-Control-Allow-Origin，或改用后端代理中转
为什么不能直接用uni.previewImage或web-view打开PDF
uni.previewImage只认图片格式，传PDF进去会卡在加载态或直接报错fail invalid image；web-view虽能加载PDF链接，但在iOS App和部分安卓厂商机上会被拦截或渲染异常，且无法回退到uni-app页面（导航栈断裂）。
- 微信小程序中
web-view加载PDF需域名提前配置业务域名，否则白屏且控制台无提示 - App端
web-view加载PDF，iOS上常出现缩放失灵、手势冲突，Android上可能触发全屏黑屏 - 真正稳定的方式仍是
downloadFile → openDocument组合，这是uni-app官方文档明确推荐的PDF处理路径
static/下的PDF可用/static/file.pdf，H5里必须写成./static/file.pdf或绝对路径，少个点或斜杠就404。还有就是忘记在manifest.json里配置iOS的NSAppTransportSecurity，导致iOS下载失败却只报“未知错误”。 
