Gradle集成Spring Boot项目执行instalDist任务后脚本无法运行：找不到或无法加载主类问题排查

看起来你遇到的问题很典型——Spring Boot项目能正常跑jar包、在IDE里也能运行，偏偏instalDist生成的脚本找不到主类。结合你的配置和同类项目的对比情况，我整理了几个关键排查点和解决方案：

1. 修正Application插件的ID拼写错误 #

先看你的build.gradle插件配置：

plugins {
    id 'application-plugin' // 这里存在错误！
    // ...其他插件
}

Gradle官方的应用插件ID是application，不是application-plugin。这个拼写错误会导致插件无法正确加载，自然生成的脚本不会包含正确的主类配置。把它改成：

plugins {
    id 'application'
    id 'groovy'
    id "org.springframework.boot" version "2.3.1.RELEASE"
}

2. 明确指定主类（核心修复点） #

错误提示里的some.package是包名，不是具体的主类，这必然会触发ClassNotFoundException。即使Spring Boot能自动检测主类，但和application插件配合时，最好显式配置主类的完整路径：

application {
    // 适配旧版Gradle写法
    mainClassName = 'some.package.YourActualMainClass'
    // 如果是Gradle 6.7+版本，可使用新写法：
    // mainClass.set('some.package.YourActualMainClass')
}

记得把YourActualMainClass替换成你项目中带有@SpringBootApplication注解的真实类名。

3. 清理缓存后重新构建 #

有时候Gradle的缓存会导致配置不生效，执行以下命令彻底清理后重新生成脚本：

./gradlew clean instalDist

完成后再去build/install/[你的项目名]/bin目录下运行脚本试试。

4. 对比正常项目的脚本配置 #

如果上面的步骤都没用，你可以打开正常项目和当前项目生成的脚本文件，对比以下内容：

• 脚本里设置的主类参数是否正确（是否具体到类，而非包）
• CLASSPATH是否包含了项目的编译产物和所有依赖jar

通过对比差异，应该能快速定位到问题所在。

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