Compose Desktop启用ProGuard后启动失败：无法启动JVM

问题本质 #

构建安装包成功但启动报错，说明ProGuard混淆时误删了JVM启动或应用初始化必需的核心类/方法——编译打包阶段没检测到依赖缺失，但运行时核心逻辑找不到直接导致JVM启动失败。

排查修复步骤 #

1. 补全核心类的ProGuard保留规则 #

打开你的compose-desktop.pro文件，添加以下基础规则，避免核心类被误删：

• 保留应用主入口类（替换成你的实际主类全路径）：

  -keep class com.yourapp.MainKt {
      public static void main(java.lang.String[]);
  }
  

• 保留Compose Desktop和Kotlin核心组件：

  -keep class androidx.compose.desktop.** { *; }
  -keep class androidx.compose.ui.** { *; }
  -keep class kotlin.** { *; }
  -keep class kotlin.Metadata { *; }
  

• 保留JVM基础类，防止启动依赖缺失：

  -keep class java.lang.** { *; }
  -keep class java.util.** { *; }
  

2. 开启ProGuard调试日志定位问题 #

修改build.gradle中的ProGuard配置，启用日志输出：

buildTypes.release.proguard {
    isEnabled.set(true)
    version.set("7.5.0")
    configurationFiles.from(project.file("compose-desktop.pro"))
    // 输出详细混淆日志到build/outputs/proguard/release目录
    isVerbose.set(true)
    isDebuggable.set(true)
}

重新构建后，查看usage.txt文件，里面会标记哪些类被判定为“未使用”并删除，针对性添加-keep规则保留这些类。

3. 验证JVM启动参数完整性 #

检查应用打包配置里的JVM启动参数是否正常，避免ProGuard篡改必要参数：

application {
    mainClass.set("com.yourapp.MainKt")
    // 确保必要的JVM参数存在，比如内存配置
    jvmArgs.add("-Xmx1g")
}

4. 隔离混淆步骤验证 #

临时关闭混淆功能，只启用压缩和优化，看是否还会报错：

buildTypes.release.proguard {
    isEnabled.set(true)
    version.set("7.5.0")
    configurationFiles.from(project.file("compose-desktop.pro"))
    // 关闭混淆，只保留压缩优化
    isObfuscation.set(false)
}

如果此时启动正常，说明是类名/方法名混淆导致的反射或动态调用失败——比如你用了Kotlin序列化、Gson这类依赖反射的库，需要额外添加对应库的ProGuard规则。

通用Compose Desktop ProGuard规则参考 #

# 应用主入口
-keep class com.yourpackage.MainKt {
    public static void main(java.lang.String[]);
}

# Compose核心组件
-keep class androidx.compose.** { *; }
-keep class org.jetbrains.compose.** { *; }

# Kotlin核心与反射支持
-keep class kotlin.** { *; }
-keep class kotlin.Metadata { *; }
-keepclassmembers class ** {
    @kotlin.jvm.JvmStatic <methods>;
    @kotlin.jvm.JvmField <fields>;
}

# JVM基础类
-keep class java.lang.** { *; }
-keep class java.io.** { *; }
-keep class java.net.** { *; }

# 若使用第三方库，需补充对应规则（比如Ktor、Room等）

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