Flutter_inappwebview 中图片上传崩溃问题的分析与解决

问题背景

在使用Flutter_inappwebview插件时，开发者遇到了一个典型的Android平台文件上传问题：当用户尝试通过网页中的文件上传按钮选择图片时，应用会意外崩溃。这个问题在多种Android设备上均有复现，包括三星Zfold 5、Redmi Note 8和三星S22等机型。

问题现象

具体表现为：

1. 当网页触发文件上传操作时，系统会弹出选择器提供两个选项：相机和文件浏览器
2. 选择相机功能可以正常工作，图片能够成功上传
3. 但选择文件浏览器并点击图片后，应用会立即崩溃并退出

错误分析

从错误日志中可以发现几个关键点：

1. 崩溃发生在Android主线程上
2. 异常类型为RuntimeException
3. 深层原因是Google Play服务的ApiException（错误码16）
4. 异常堆栈指向了OTP自动填充插件的处理逻辑

根本原因

经过深入排查，发现问题并非出在Flutter_inappwebview插件本身，而是由项目中同时使用的OTP自动填充插件（otp_autofill）引起的。该插件错误地拦截并处理了文件选择器的返回结果，导致系统无法正确处理图片选择操作。

解决方案

1. 临时解决方案：移除或禁用otp_autofill插件，这可以立即解决文件上传崩溃问题
2. 长期方案：如果项目确实需要OTP自动填充功能，可以考虑：
   • 联系插件作者报告此兼容性问题
   • 寻找替代的OTP自动填充解决方案
   • 等待插件更新修复此问题

技术启示

这个案例给我们几个重要的技术启示：

1. 插件冲突排查：当遇到难以解释的崩溃时，应考虑插件间的相互影响
2. 权限处理机制：Android的文件选择和结果处理机制较为复杂，插件需要正确实现相关回调
3. 错误日志分析：学会从错误堆栈中识别真正的问题源头，避免被表面现象误导

最佳实践建议

1. 在集成多个插件时，应逐步测试各功能的交互情况
2. 对于涉及系统级操作（如文件选择、相机调用等）的功能，要进行充分的跨插件测试
3. 保持插件版本更新，及时修复已知的兼容性问题

通过这个案例，我们不仅解决了具体的技术问题，更重要的是学习了如何系统性地分析和解决Flutter开发中的复杂问题。