IDEA刷新Gradle项目提示:subproject找不到wrapper任务解决方法

Task 'wrapper' not found in project ':subproject'报错来自两个配置疏漏：

• 根项目缺失统一的多模块构建规则，IDEA适配Gradle 6.8.3的旧逻辑会遍历所有应用了生命周期插件的子项目查找wrapper任务，而wrapper任务默认仅在根项目存在
• Spring Boot 2.7.0版本的插件初始化逻辑会在所有应用它的项目中触发构建任务扫描，子项目单独配置插件且没有声明跳过wrapper任务校验时就会触发报错
  另外原配置中子项目build.gradle里spring-boot-starter-web依赖末尾漏了闭合单引号，也会在后续构建时触发语法错误。

不需要给子项目单独配置wrapper任务，按以下步骤调整即可：

1. 新增根项目build.gradle #

当前根目录只有settings.gradle，缺失根项目构建配置，在根目录新建build.gradle，统一管理所有子项目的通用规则：

allprojects {
    repositories {
        mavenCentral()
    }
}

subprojects {
    apply plugin: 'java'
    apply plugin: 'io.spring.dependency-management'

    group = 'com.demo'
    version = '1.0.0-SNAPSHOT'
    sourceCompatibility = '11'

    // 统一测试配置
    tasks.named('test') {
        useJUnitPlatform()
    }

    // *核心配置*：非根项目直接禁用wrapper任务，避免IDEA扫描报错
    tasks.whenTaskAdded { task ->
        if (task.name == 'wrapper' && project != rootProject) {
            task.enabled = false
        }
    }
}

2. 精简子项目构建配置 #

修改subproject/build.gradle，删除重复的通用配置，补上依赖缺失的单引号：

plugins {
    id 'org.springframework.boot' version '2.7.0'
}

dependencies {
    implementation 'org.springframework.boot:spring-boot-starter-web'
    testImplementation 'org.springframework.boot:spring-boot-starter-test'
}

3. 优化settings.gradle配置 #

在原有settings.gradle的插件仓库中补充mavenCentral，避免插件解析失败：

pluginManagement {
    repositories {
        gradlePluginPortal()
        mavenCentral()
    }
}

rootProject.name = 'root'
include 'subproject'

1. 先在根目录执行./gradlew clean，确认命令行执行无报错
2. 回到IDEA点击Gradle面板的刷新按钮，原有wrapper报错会直接消失
3. 执行./gradlew build可验证根项目和子项目同步构建，子项目的Spring Boot可执行包会正常输出到subproject/build/libs目录，满足同Pod部署的构建要求

如果刷新后IDEA仍有缓存报错，直接删除项目根目录下的.gradle缓存文件夹，重启IDEA重新导入即可。

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