第4章 权限状态管理：单次请求状态、多次拒绝状态、不再询问状态、状态机设计

Android 运行时权限的交互过程不是简单的“请求→允许/拒绝”二值逻辑。用户可能暂时拒绝、永久拒绝并勾选“不再询问”，也可能在拒绝后再次触发请求。如果不对这些中间状态进行管理，应用会出现弹窗无法弹出、权限状态混乱、用户无法恢复操作的严重问题。本章将定义标准化权限状态机，并从原理、实现、调试、优化四个维度完整覆盖状态管理方案。

4.1 核心状态定义

根据 Android 官方行为和 Material 3 权限对话框设计规范，权限请求生命周期包含以下 5 种离散状态：

状态名称标识含义典型触发条件
初始（未请求）IDLE从未对该权限进行过请求应用首次启动、权限从未被访问
授予GRANTED用户已允许该权限用户点击“允许”按钮
拒绝（单次）DENIED_ONCE用户本次拒绝，但下次仍可再次弹窗用户点击“拒绝”且未勾选“不再询问”
拒绝（多次+不再询问）DENIED_FOREVER用户已勾选“不再询问”或连续拒绝超过系统阈值用户点击“拒绝”并勾选“不再询问”；或连续拒绝 2 次后系统自动写入不再询问标记
请求中REQUESTING正在弹出系统对话框或自定义 Material 3 对话框调用 requestPermissions() 后尚未回调
📌 关键差异：“单次拒绝”状态下 shouldShowRequestPermissionRationale() 返回 true，弹窗后系统仍允许再次请求；而“不再询问”状态下该方法返回 false，所有请求都会被系统静默拒绝，必须引导用户前往设置页手动开启。

4.2 状态机设计

为了保证状态转换可预测、无遗漏，我们引入有限状态机模型。下图描述了完整的权限生命周期状态流转：

权限请求状态机（5 状态 · 8 转换） IDLE (初始) REQUESTING GRANTED DENIED_ONCE DENIED_FOREVER 请求权限 用户允许 用户拒绝 再次请求 不再询问 设置中开启 设置中关闭
状态转换说明：
  • 实线箭头：正常业务流转（请求 → 授予/拒绝 → 再次请求 → 不再询问）。
  • 虚线箭头：用户手动进入系统设置修改权限后返回应用时的恢复路径。
  • 所有转换由 onRequestPermissionsResult 回调或 shouldShowRequestPermissionRationale() 方法驱动。

4.3 实现流程：Kotlin 状态机封装

我们使用 sealed class + 协程 Flow 实现线程安全、可观察的状态机核心。以下是完整实现：

sealed class PermissionState {
    object Idle : PermissionState()
    object Requesting : PermissionState()
    data class DeniedOnce(val permission: String) : PermissionState()
    data class DeniedForever(val permission: String) : PermissionState()
    data class Granted(val permission: String) : PermissionState()
}

class PermissionStateMachine(private val permission: String) {

    private val _state = MutableStateFlow<PermissionState>(PermissionState.Idle)
    val state: StateFlow<PermissionState> = _state.asStateFlow()

    fun onRequest() {
        _state.update { current ->
            when (current) {
                is PermissionState.Idle,
                is PermissionState.DeniedOnce -> PermissionState.Requesting
                is PermissionState.Requesting -> current // 防止重复触发
                is PermissionState.DeniedForever,
                is PermissionState.Granted -> current // 不再发射请求
            }
        }
    }

    fun onResult(granted: Boolean, shouldShowRationale: Boolean) {
        _state.update { current ->
            if (current !is PermissionState.Requesting) return@update current
            when {
                granted -> PermissionState.Granted(permission)
                !shouldShowRationale -> PermissionState.DeniedForever(permission)
                else -> PermissionState.DeniedOnce(permission)
            }
        }
    }

    fun onSettingsResult() {
        // 从设置页返回后，重新检查权限
        _state.update {
            if (it is PermissionState.DeniedForever) PermissionState.Idle
            else it
        }
    }
}
⚠️ 常见错误：直接在 Activity / Fragment 中使用临时布尔变量记录状态，忽略屏幕旋转和进程重建导致的状态丢失。必须将状态机实例化在 ViewModel 中，并利用 SavedStateHandle 持久化 DeniedForever 标记，因为该状态跨越 Activity 生命周期。

4.4 API 与回调集成

将状态机绑定到 ActivityResultContracts.RequestPermission：

private val permissionLauncher = registerForActivityResult(
    ActivityResultContracts.RequestPermission()
) { granted ->
    val rationale = shouldShowRequestPermissionRationale(permission)
    stateMachine.onResult(granted, rationale)
    Log.d("PermissionSM", "State: ${stateMachine.state.value}")
}

fun requestWithStateMachine() {
    stateMachine.onRequest()
    if (stateMachine.state.value is PermissionState.DeniedForever) {
        // 直接跳转设置页
        Intent(Settings.ACTION_APPLICATION_DETAILS_SETTINGS).apply {
            data = Uri.parse("package:${context.packageName}")
            startActivity(this)
        }
        return
    }
    permissionLauncher.launch(permission)
}

4.5 调试技巧

  • 启用权限日志标签：在 onResult() 中输出当前状态和 shouldShowRationale 值，观察系统行为。
  • 模拟“不再询问”状态：在真机或模拟器中，连续拒绝 2 次并勾选“不再询问”；使用 adb shell pm reset-permissions 重置所有权限状态。
  • 检查状态机是否正确转换：编写单元测试，覆盖 DeniedOnce → Requesting 和 DeniedForever → Idle（设置页返回后）两条关键虚线路径。
  • 监控重复请求：如果日志中 REQUESTING 状态出现超过 3 次且用户未操作，说明 UI 层可能一直在发射请求，应该增加请求去重逻辑。

4.6 性能与稳定性优化

问题原因优化方案
状态机更新频繁触发重组StateFlow 在 Activity 重建时发射历史值使用 stateIn(WhileSubscribed) 或在 Compose 中使用 snapshotFlow 避免重复渲染
用户快速连续点击“请求”按钮onRequest() 未做去重在 onRequest() 中检查当前是否为 REQUESTING 状态，直接跳过请求发射
从设置页返回后状态未重置未监听 onResume() 或未调用 onSettingsResult()在 onResume() 中重新检查权限并调用 onSettingsResult()，同时使用 lifecycleScope 确保安全性
多权限并发请求状态混乱每个权限使用同一个状态机实例为每个权限创建独立的 PermissionStateMachine 实例，通过 Map<String, PermissionStateMachine> 管理
📦 推荐架构：在 ViewModel 中使用 SavedStateHandle 存储 DENIED_FOREVER 标记，避免进程重建后丢失“不再询问”状态。示例： 
class PermissionViewModel(savedStateHandle: SavedStateHandle) : ViewModel() {
    private val foreverKey = "perm_camera_forever"
    private var isDeniedForever: Boolean
        get() = savedStateHandle.get<Boolean>(foreverKey) ?: false
        set(value) = savedStateHandle.set(foreverKey, value)
}

4.7 常见错误与排查指南

  • ❌ 错误：弹窗不出现但用户从未拒绝
    原因：状态机处于 DENIED_FOREVER，但 shouldShowRationale 未正确读取。解决：确认弹窗条件使用 stateMachine.state.value is DeniedForever 而非仅检查 shouldShowRequestPermissionRationale()，因为系统可能在首次拒绝时返回 false。
  • ❌ 错误：多次拒绝后不显示引导对话框
    原因：未在 DeniedForever 状态下跳转设置页。解决：在 requestWithStateMachine() 中增加判断，直接打开系统设置。
  • ❌ 错误：屏幕旋转后状态丢失
    原因：状态机实例化在 Activity 内。解决：迁移至 ViewModel，状态恢复由 SavedStateHandle 处理。
← 上一章 📖 返回目录 下一章 →