最稳方案是先下载文件到临时路径再用uni.openDocument打开；因web-view不支持PDF直链和Base64，且安卓无WPS时openDocument会静默失败。
微信小程序里用 uni-app 预览 doc、pdf 等文件，**不能直接用 web-view 加载外链 PDF 或 Base64 数据 URL**，真机基本白屏或报错；最稳的路径是：**先下载到临时路径，再调 uni.openDocument 打开**——这是微信原生支持、兼容性最好、无需额外域名配置（除 download 域名外）的方案。
为什么 web-view + PDF 外链/URL 在真机上大概率失败
微信对 web-view 的限制很明确：web-view 只能加载已配置在「业务域名」里的 HTTPS 页面，且该页面必须是完整 HTML（不能是裸 PDF 文件）。PDF 文件直链（如 https://xxx.com/a.pdf）不被 web-view 渲染，会直接触发下载或空白。即使你把 PDF 包进一个 H5 页面里用 pdf.js 渲染，也面临两个硬伤：
- 安卓端
web-view内核老旧，pdf.js渲染极易卡死或白屏 - 需额外申请并验证「业务域名」，且每次变更都要重新上传校验文件，上线流程变重
- Base64 data URL（
data:application/pdf;base64,...）在真机上完全不识别，开发者工具能跑只是模拟器宽松
uni.downloadFile + uni.openDocument 是当前最可靠组合
微信原生 API uni.openDocument 明确支持 .pdf、.doc、.docx、.xls、.xlsx、.ppt、.pptx，只要文件已存在本地临时路径，就能唤起系统文档查看器（iOS 用 QuickLook，安卓依赖 WPS/Office 等已安装应用）。
实操要点：
公众号运营：文章发布至草稿、样式封面、评论与用户管理、数据统计等。用户要求将 Markdown 发送到公众号草稿、查看阅读量统计或类似后台操作时，使用本技能。
- 必须确保文件 URL 已加入「downloadFile 合法域名」（微信公众平台 → 开发管理 → 下载域名）
- 下载成功后，务必使用
res.tempFilePath（不是res.filePath），后者在部分安卓机型上为空 - 调
uni.openDocument前建议加showMenu: true，否则 iOS 上无法长按复制/转发 - 文件后缀必须准确，比如
xxx.PDF（大写）可能被误判，建议统一转小写再判断
示例片段：
const previewDoc = async (url) => {
try {
uni.showLoading({ title: '加载中' });
const res = await uni.downloadFile({ url });
if (res.statusCode !== 200) throw new Error('下载失败');
await uni.openDocument({
filePath: res.tempFilePath,
showMenu: true
});
} catch (err) {
uni.showToast({ title: '预览失败', icon: 'none' });
console.error(err);
} finally {
uni.hideLoading();
}
};
图片和文档要分开处理，别混用同一套逻辑
图片（jpg/png/gif）走 uni.previewImage，文档走 uni.openDocument，二者底层机制完全不同：
-
uni.previewImage直接传 URL 数组，不下载，不占空间，秒开，但只认图片格式 -
uni.openDocument必须传本地临时路径，有 IO 开销，但支持格式广、体验接近原生 - 如果统一用
downloadFile下载后再判断类型，注意图片也走这套会多一次磁盘写入，非必要不推荐
简单判断可这样写：
const ext = url.split('.').pop()?.toLowerCase();
if (['jpg', 'jpeg', 'png', 'gif'].includes(ext)) {
uni.previewImage({ urls: [url] });
} else {
// 走 download + openDocument
}
真正容易被忽略的点是：**安卓设备没装 WPS 或 Office 类应用时，uni.openDocument 会静默失败，连 fail 回调都不触发**。这时候只能降级提示“请安装文档查看应用”，没法自动兜底——这个兼容边界，上线前务必用真机测透。
