Spring Boot Gradle插件报错：无法为SpringBootExtension设置mainClass属性

报错信息：无法为org.springframework.boot.gradle.dsl.SpringBootExtension类型的对象设置未知属性'mainClass'。

报错原因分析 #

你遇到的这个错误核心原因是Spring Boot Gradle插件的API在版本迭代中发生了变更：

• 在Spring Boot 2.0之前的插件版本中，我们可以直接通过springBoot扩展的mainClass属性来指定主类；
• 但从Spring Boot 2.0开始，SpringBootExtension不再暴露mainClass这个可直接赋值的属性，取而代之的是Property<String>类型的mainClass对象，需要通过方法调用或者任务配置来设置主类。

从你的根build.gradle代码来看，你引入了spring-boot-gradle-plugin并使用版本变量${spring_boot_version}，如果这个版本是2.0及以上，直接赋值mainClass = 'xxx'就会触发这个"未知属性"的错误。

解决方法 #

结合你的多模块项目结构（包含common、core、web、app子项目），推荐以下几种解决方案：

1. 直接在任务中指定主类（最直观）

如果你只是需要为可执行JAR打包或本地运行指定主类，可以直接在bootJar或bootRun任务里配置：

// 配置可执行JAR打包任务的主类
bootJar {
    mainClass = 'com.yourpackage.YourMainApplication'
}

// 可选：单独配置本地运行任务的主类（如果和打包主类一致可以省略）
bootRun {
    mainClass = 'com.yourpackage.YourMainApplication'
}

💡 注意：这个配置只需要放在你的启动模块（比如app子项目）的build.gradle中即可，common、core这类依赖模块不需要配置主类。

2. 通过SpringBootExtension的方法设置主类

如果你习惯在springBoot扩展块中配置，可以使用mainClass.set()方法来赋值（符合新版本插件的API规范）：

springBoot {
    mainClass.set('com.yourpackage.YourMainApplication')
}

3. 兼容新旧版本的写法（可选）

如果你的项目需要同时兼容新旧版本的Spring Boot插件，可以添加条件判断来适配：

springBoot {
    if (hasProperty('mainClass')) {
        // 适配旧版本插件的属性赋值方式
        mainClass = 'com.yourpackage.YourMainApplication'
    } else {
        // 适配新版本插件的Property对象设置方式
        mainClass.set('com.yourpackage.YourMainApplication')
    }
}

额外优化建议 #

你的根build.gradle中对所有javaProjects统一配置，但common、core这类子项目通常不需要Spring Boot插件，建议只在app子项目中单独应用spring-boot插件并配置主类，这样可以避免不必要的配置冲突，让模块职责更清晰。

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