Flutter Permission Handler 外部存储权限处理异常分析

问题现象描述

在使用 Flutter Permission Handler 处理 Android 外部存储权限时，开发者报告了一个严重的崩溃问题。当用户在系统设置中反复切换外部存储权限状态（先授予再撤销）后返回应用时，会导致应用崩溃，并抛出空指针异常。

异常堆栈分析

从错误日志可以看到，崩溃发生在 PermissionManager.onActivityResult 方法中，具体是尝试在一个空 Map 对象上调用 put 方法时触发的空指针异常。这个异常链始于 Activity 恢复时的结果传递过程，最终在权限处理模块中崩溃。

技术背景

在 Android 系统中，处理运行时权限时通常涉及以下几个关键环节：

1. 应用通过 startActivityForResult 启动系统权限设置界面
2. 用户在系统设置中修改权限状态
3. 系统通过 onActivityResult 回调将结果返回给应用
4. 应用处理权限变更结果

Flutter Permission Handler 作为桥接层，需要妥善处理这些原生 Android 交互流程，并将结果转换为 Flutter 可理解的格式。

问题根源

经过分析，这个问题的根本原因在于：

1. 当应用被切换到系统设置界面时，Flutter 引擎可能被系统回收或进入非活跃状态
2. 返回应用时，权限处理模块尝试将结果存入一个尚未初始化的 Map 对象
3. 缺乏对 Map 对象空状态的防御性检查

解决方案建议

针对这类问题，开发者可以采取以下措施：

1. 防御性编程：在权限回调处理中加入空对象检查

if (resultMap != null) {
  resultMap.put(key, value);
}

2. 状态恢复处理：在应用恢复时重新初始化必要的状态对象

3. 权限请求时机优化：避免在应用启动时立即请求权限，改为在真正需要时请求

4. 异常捕获：在权限处理流程中加入全局异常捕获机制

最佳实践

在使用 Flutter Permission Handler 处理存储权限时，建议：

1. 采用懒加载方式请求权限，只在真正需要时发起请求
2. 实现完善的错误处理回调
3. 在应用恢复时检查权限状态是否发生变化
4. 考虑使用 try-catch 包裹权限请求代码

总结

权限处理是移动应用开发中的关键环节，特别是在 Android 系统上。Flutter Permission Handler 虽然简化了权限处理流程，但仍需开发者理解其底层机制并做好异常情况处理。通过合理的架构设计和防御性编程，可以有效避免类似崩溃问题的发生。