XXPermissions框架中Fragment权限请求崩溃问题解析

问题背景

在Android开发中，权限请求是一个常见但容易出错的环节。XXPermissions作为一款优秀的权限请求框架，近期在Fragment中使用时出现了一个值得注意的问题：当用户同时拒绝网络和精准定位权限时，应用会发生崩溃，而单独拒绝其中一项权限则表现正常。

问题现象

开发者在Fragment中同时请求ACCESS_FINE_LOCATION和ACCESS_COARSE_LOCATION权限时，如果用户全部拒绝，应用会抛出IllegalStateException异常，提示"Fragment not attached to a context"。这个问题在小米10和小米13设备上必现，Android版本为13，targetSdkVersion为33。

问题根源分析

通过异常堆栈可以清楚地看到问题发生的路径：

1. 权限请求被拒绝后，回调到onDenied方法
2. 在onDenied中使用了lifecycleScope.launch启动协程
3. 协程中使用了requireContext()获取上下文
4. 此时Fragment可能已经与Activity解绑，导致requireContext()抛出异常

关键在于权限请求是异步操作，当用户做出选择时，Fragment的生命周期状态可能已经发生了变化。特别是在小米设备上，权限弹窗的显示时间较长，增加了Fragment解绑的可能性。

解决方案演进

初级解决方案

开发者最初采用的解决方案是在回调中显式检查Fragment状态：

override fun onDenied(permissions: MutableList<String>, doNotAskAgain: Boolean) {
    val activity = activity
    if (activity != null && isAdded) {
        ToastUtil.show(activity, getString(R.string.text_fail_obtain_location_permission))
        XXPermissions.startPermissionActivity(activity, permissions)
    }
}

这种方法虽然能解决问题，但需要在每个回调中都进行状态检查，增加了代码复杂度和维护成本。

框架优化方案

XXPermissions框架在22.0版本中对此问题进行了优化，内部自动处理了Fragment的生命周期状态检查。框架的实现思路是：

1. 在权限请求开始时，保存当前的Fragment状态引用
2. 在回调触发时，先检查Fragment是否仍然有效
3. 只有状态有效时才执行开发者定义的回调逻辑

这种方案将生命周期管理的责任从开发者转移到了框架内部，大大简化了使用方式，开发者现在可以直接使用requireActivity()而不用担心崩溃问题。

最佳实践建议

1. 及时更新框架版本：使用最新版的XXPermissions框架(23.0及以上)，该版本不仅修复了Fragment生命周期问题，还解决了Android 6.0设备上存储权限判断的崩溃问题。

2. 正确处理权限拒绝流程：即使框架提供了保护，在业务逻辑上仍应考虑权限被拒绝后的用户体验，如提供友好的提示和引导。

3. 注意权限分组：Android系统对权限进行了分组，特别是位置相关权限，建议同时请求ACCESS_FINE_LOCATION和ACCESS_COARSE_LOCATION，但要做好全部被拒绝的处理。

4. 测试覆盖：在真机上测试各种权限组合的拒绝场景，特别是低版本Android设备的兼容性测试。

总结

权限管理是Android开发中的关键环节，XXPermissions框架通过不断优化，为开发者提供了更加稳定和易用的解决方案。理解框架背后的实现原理，能帮助我们在实际开发中更好地规避类似问题，构建更加健壮的应用程序。对于Fragment中的权限请求，开发者现在可以放心使用最新版本的XXPermissions框架，无需再手动处理复杂的生命周期状态检查。