HarmonyOS鸿蒙Next华为 Mate 70 Pro系统3.0.0 小程序webview pdfjs使用问题

这确实是一个在 HarmonyOS（鸿蒙）系统上开发 H5 或小程序时比较典型的兼容性问题。

问题核心： pdfjs 报错 failed to fetch，意味着 JavaScript 代码试图通过网络请求（通常是 fetch API）去获取 PDF 文件，但在 HarmonyOS 的 webview 环境中这个请求被拦截、阻止或无法正确执行。而在 Android 和 iOS 上，webview 对本地文件或跨域请求的处理相对宽松或机制不同，所以运行正常。

原因分析：

1. HarmonyOS Webview 的 Fetch 支持问题： 早期版本的 HarmonyOS webview 对现代 Web API（如 fetch）的支持可能不如 Chrome (Android) 或 WebKit (iOS) 完善，或者存在特定的配置要求。
2. 文件路径/协议问题：
   • H5 页面通常是加载在 file:// 协议或者是小程序的自定义协议下。
   • pdfjs 尝试加载 PDF 时，如果传入的是相对路径或 file:// 路径，HarmonyOS 的安全策略可能禁止了 fetch 去读取本地文件系统资源。
   • 如果 PDF 是网络资源，可能是跨域（CORS）策略在鸿蒙系统上被更严格地执行了。
3. 小程序沙箱限制： 如果是在小程序的 web-view 组件中，小程序容器本身对网络请求有白名单限制，且对本地文件访问有严格的沙箱隔离。鸿蒙系统可能对 web-view 内部的 fetch 请求做了额外的拦截。

解决方案建议：

你可以尝试以下几种方案来解决这个问题：

方案一：使用 XMLHttpRequest 替代 fetch (推荐)

pdfjs 内部通常会自动检测环境，但有时在特定环境下检测失效。你可以尝试在引入 pdfjs 之前，强制让环境支持 fetch，或者修改 pdfjs 的加载逻辑。

更直接的方法是，在调用 pdfjs.getDocument() 时，不要直接传 URL，而是先通过其他方式获取数据流。

方案二：将文件转换为 Base64 (最稳妥)

这是解决 webview 本地文件读取问题最通用的办法。

1. 获取文件流： 在小程序端（鸿蒙侧），通过小程序的文件 API 读取 PDF 文件。
2. 转 Base64： 将文件内容转换为 Base64 字符串。
3. 传给 H5： 通过 postMessage 将 Base64 字符串传给 web-view 内的 H5 页面。
4. 加载： H5 接收到 Base64 后，直接交给 pdfjs 渲染。

H5 代码示例：

// 假设 base64Data 是从小程序传过来的
const loadingTask = pdfjsLib.getDocument({ data: atob(base64Data) });
loadingTask.promise.then(function(pdf) {
  // 渲染逻辑
});

方案三：检查并配置网络白名单与跨域

如果 PDF 是网络文件：

1. 确保 PDF 的域名已添加到小程序的 request 和 downloadFile 合法域名列表中。
2. 确保服务器端返回了正确的 Access-Control-Allow-Origin: * 头，因为鸿蒙 webview 可能会严格执行 CORS。

方案四：使用 url 参数时的特殊处理

如果你必须使用 URL 加载，尝试将本地文件路径转换为可以通过网络访问的形式（如果可能），或者检查 pdfjs 的版本。较新的 pdfjs 版本对环境的兼容性更好。

总结建议： 考虑到这是鸿蒙 3.0（相对较老的版本）且是在小程序环境中，方案二（Base64 传输） 是成功率最高、兼容性最好的方案，因为它完全绕过了 webview 内部对文件路径和 fetch 网络请求的限制。