Android Studio中Jetpack Compose预览因rememberPermissionState报错

问题根源 #

• 预览环境权限上下文缺失：Compose预览运行在简化的沙盒Activity中，没有完整的Android系统权限管理上下文，rememberPermissionState这类API依赖系统权限服务初始化状态，预览环境无法提供，导致预览进程静默崩溃，IDE错误面板无法捕获具体异常。
• 实验性API预览适配不足：你使用的Accompanist权限API处于实验阶段，官方尚未针对Compose预览场景做完善适配，预览环境无法处理这类API的初始化逻辑。

解决办法 #

1. 预览环境跳过权限逻辑 #

通过LocalInspectionMode.current判断是否处于预览状态，预览时用模拟的权限状态替代真实权限逻辑，不影响正常构建运行：

@Composable
@ExperimentalPermissionsApi
fun PermissionScreen() {
    val isPreview = LocalInspectionMode.current
    val permissionState = if (!isPreview) {
        rememberPermissionState(android.Manifest.permission.CAMERA)
    } else {
        // 预览时返回模拟的已授权状态，可根据需求调整
        object : PermissionState {
            override val permission: String = android.Manifest.permission.CAMERA
            override val status: PermissionStatus = PermissionStatus.Granted
            override fun launchPermissionRequest() {}
        }
    }

    // 业务逻辑
    when (permissionState.status) {
        PermissionStatus.Granted -> Text("权限已获取")
        is PermissionStatus.Denied -> Button(onClick = permissionState::launchPermissionRequest) {
            Text("请求权限")
        }
    }
}

2. 升级Accompanist版本 #

旧版本的Accompanist权限库存在预览兼容性bug，升级到最新稳定版（如0.32.0及以上），官方后续版本已修复部分预览适配问题。

3. 确保实验性API配置正确 #

在模块的build.gradle.kts（或build.gradle）中正确启用实验性API的编译参数，避免预览时因API限制报错：

android {
    composeOptions {
        kotlinCompilerExtensionVersion = "1.5.3" // 匹配你的Compose版本
    }
    kotlinOptions {
        freeCompilerArgs += "-opt-in=com.google.accompanist.permissions.ExperimentalPermissionsApi"
    }
}

内容的提问来源于stack exchange，提问作者Leteps