Flutter InAppWebView 中 WebKitErrorDomain 下载问题的解决方案

问题背景

在使用 Flutter InAppWebView 插件时，开发者可能会遇到一个特定的问题：当尝试在 iOS 设备上预览下载的 PDF 文件时，WebView 会抛出 WebKitErrorDomain 错误，错误代码为 102，并显示"Frame load interrupted"的错误信息。尽管文件实际上已经成功下载，但预览功能无法正常工作。

错误现象

具体表现为：

1. 用户点击网页中的下载按钮触发下载
2. onDownloadStartRequest 方法被正确调用
3. 文件能够成功下载到设备
4. 但在 WebView 内尝试预览文件时出现错误
5. 错误信息为：{type: -1, description: domain=WebKitErrorDomain, code=102, Frame load interrupted}

值得注意的是，同样的操作在常规网页浏览器中能够正常工作，文件可以正常预览。

问题分析

这个错误通常发生在 WebView 尝试加载或渲染 PDF 文件时。WebKitErrorDomain 错误代码 102 表示框架加载被中断，这通常与 WebView 的配置或处理特定内容类型的方式有关。

在 Flutter InAppWebView 插件中，useOnNavigationResponse 设置项可能会影响 WebView 对某些内容类型的处理方式。当这个选项被启用时，WebView 可能会以不同的方式处理导航响应，从而导致 PDF 预览失败。

解决方案

经过长期探索，开发者发现了一个有效的解决方案：

禁用 useOnNavigationResponse 设置

具体实现方式是在创建 InAppWebView 时，确保 InAppWebViewSettings 中不包含 useOnNavigationResponse 键，或者显式地将其设置为 false。

InAppWebView(
  initialSettings: InAppWebViewSettings(
    // 不要包含 useOnNavigationResponse 或者设置为 false
    // useOnNavigationResponse: false,
  ),
)

技术原理

useOnNavigationResponse 是 Flutter InAppWebView 插件中的一个设置项，它控制着 WebView 如何处理导航响应。当启用时，它会拦截所有导航响应，让开发者有机会决定是否允许加载特定内容。

对于 PDF 文件，iOS 的 WKWebView 有自己的一套处理机制。当 useOnNavigationResponse 被启用时，可能会干扰 WKWebView 原生的 PDF 预览功能，导致框架加载被中断。

最佳实践

1. 如果您的应用不需要拦截和自定义处理导航响应，建议保持 useOnNavigationResponse 为默认值（未设置或 false）
2. 如果需要处理某些特定的导航响应，可以考虑在 onLoadStart 或 onLoadStop 回调中进行处理
3. 对于 PDF 预览功能，可以结合使用 url_launcher 插件，在外部应用中打开 PDF 文件，提供更好的用户体验

总结

Flutter InAppWebView 插件是一个功能强大的工具，但在处理特定内容类型时可能会遇到一些挑战。通过理解 WebView 的工作机制和各个设置项的影响，开发者可以更好地解决类似的问题。对于 PDF 预览问题，禁用 useOnNavigationResponse 设置是一个经过验证的有效解决方案。