Jetpack Compose：@PreviewParameter传Boolean结合StateFlow预览报错排查

我需要预览一个Compose UI，希望为isVerifyBtnEnabledState展示两种不同状态，因此通过如下方式使用@PreviewParameter：

@Preview(
    name = "EN-Phone-portrait",
    locale = "en",
    device = Devices.PHONE,
    showBackground = true,
    backgroundColor = 0x111,
    showSystemUi = true
)
@Preview(
    name = "EN-Tablet-landscape",
    locale = "en",
    device = Devices.TABLET,
    showBackground = true,
    backgroundColor = 0x111,
    showSystemUi = true
)
@Preview(
    name = "EN-Tablet-portrait",
    locale = "en",
    device = "spec:id=reference_phone,shape=Normal,width=800,height=1280,unit=dp,dpi=420",
    showBackground = true,
    backgroundColor = 0x111,
    showSystemUi = true
)
@Composable
private fun PhonePreviewVerificationCodeScreen(
    @PreviewParameter(VerifyBtnEnabledStateProvider::class) verifyBtnEnabledState: Boolean
) {
    val userEmailState: StateFlow<String> = remember { MutableStateFlow("TEST") }
    val isVerifyBtnEnabledState: MutableStateFlow<Boolean> = remember { MutableStateFlow(value = verifyBtnEnabledState) }
    val isUserVerificationCodeErrorState: StateFlow<Boolean> = remember { MutableStateFlow(value = false) }

    DrawVerificationCodeScreen(
        userEmailState = userEmailState,
        isVerifyBtnEnabledState = isVerifyBtnEnabledState,
        isUserVerificationCodeErrorState = isUserVerificationCodeErrorState
    ) { /* nothing */ }
}

class VerifyBtnEnabledStateProvider : PreviewParameterProvider<Boolean> {
    override val values: Sequence<Boolean> = sequenceOf(true, false)
}

我通过VerifyBtnEnabledStateProvider提供true和false值，预期能看到两种状态的预览，但实际出现Render issue，报错信息如下：

java.lang.ClassNotFoundException: myclasspath at java.lang.ClassLoader.loadClass  at java.lang.ClassLoader.loadClass  at java.lang.Class.forName0  at java.lang.Class.forName  at androidx.compose.ui.tooling.ComposableInvoker.invokeComposable

请问我遗漏了什么？

这个报错是因为Compose预览工具无法加载你的VerifyBtnEnabledStateProvider类，通常是访问权限或构建配置问题，按以下步骤排查修复：

• 修改Provider类的访问权限
  确保VerifyBtnEnabledStateProvider是public可见性（不要用private或包级私有），或者直接将它声明为object单例类，这样预览工具更容易加载：

  // 改为object单例
  object VerifyBtnEnabledStateProvider : PreviewParameterProvider<Boolean> {
      override val values: Sequence<Boolean> = sequenceOf(true, false)
  }
  

  或者保持类但添加public修饰符（如果在不同包下必须这么做）：

  public class VerifyBtnEnabledStateProvider : PreviewParameterProvider<Boolean> {
      override val values: Sequence<Boolean> = sequenceOf(true, false)
  }
  

• 检查Compose Tooling依赖
  确认你的模块build.gradle（或build.gradle.kts）中正确引入了预览工具依赖：

  dependencies {
      debugImplementation "androidx.compose.ui:ui-tooling:${compose_version}"
      implementation "androidx.compose.ui:ui-tooling-preview:${compose_version}"
  }
  

  替换${compose_version}为你项目使用的Compose版本号。

• 清理缓存并重建项目
  Android Studio的缓存可能导致类加载异常，点击菜单File -> Invalidate Caches... -> Invalidate and Restart，重启后重新构建项目。

• 避免预览Composable的private修饰符（可选）
  虽然private修饰符的Composable也能预览，但部分场景下会和PreviewParameter配合出现问题，你可以尝试去掉PhonePreviewVerificationCodeScreen的private修饰符测试。

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