Jetpack Compose预览无法渲染，报ClassNotFoundException求助

问题背景 #

使用Jetpack Compose 1.2.0（已尝试升级至最新版），依赖配置如下：

implementation "androidx.compose.ui:ui-tooling-preview:$compose_version"
debugImplementation "androidx.compose.ui:ui-tooling:$compose_version"
compose_version = '1.2.0'

项目全局应用自定义主题WizardTheme，MaintenanceFullScreenComponent在真机运行正常，但预览完全无法渲染，核心异常信息：

java.lang.ClassNotFoundException: _layoutlib_._internal_.kotlin.jvm.internal.Intrinsics
at com.android.tools.idea.rendering.classloading.loaders.DelegatingClassLoader.findClass(DelegatingClassLoader.kt:81)
at java.base/java.lang.ClassLoader.loadClass(ClassLoader.java:587)
at java.base/java.lang.ClassLoader.loadClass(ClassLoader.java:520)
at androidx.compose.ui.tooling.ComposeViewAdapter.<init>(ComposeViewAdapter.kt)
...

解决方案 #

1. 同步Kotlin与Compose版本 #

Compose与Kotlin版本有严格兼容要求，升级Compose后必须同步匹配Kotlin版本：

在项目根目录build.gradle中更新Kotlin插件版本：

plugins {
    id 'com.android.application' version '7.4.2' apply false
    id 'org.jetbrains.kotlin.android' version '1.9.0' apply false
}

2. 清理缓存并重启IDE #

• 执行File > Invalidate Caches...，勾选Clear file system cache and local history后点击Invalidate and Restart
• 手动删除项目下的.gradle、.idea、build文件夹，重新执行Sync Project with Gradle Files

3. 强制在预览中指定主题 #

显式在预览Composable中包裹自定义主题，避免全局主题在预览环境加载异常：

@Preview(showBackground = true)
@Composable
fun MaintenanceFullScreenPreview() {
    WizardTheme {
        MaintenanceFullScreenComponent(
            onTryAgainClick = {}
        )
    }
}

4. 检查自定义主题的资源引用 #

排查WizardTheme中引用的资源（如WizardTheme.assets.maintenanceScreen）是否在预览环境可访问：

• 确认资源文件存在于正确目录（如drawable）
• 临时替换为系统默认资源（如painterResource(R.drawable.ic_launcher_foreground)）测试预览是否恢复

5. 更新Android Studio到最新稳定版 #

旧版IDE的布局渲染器存在Compose兼容性问题，升级至Electric Eel（2022.1.1）或Flamingo（2023.1.1）等稳定版可解决此类ClassNotFound问题

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