Gradle构建报错：spotless Java存在多个google-java-format步骤

一、Spotless重复步骤错误排查与修复 #

错误核心原因是根项目和模块的build.gradle中重复配置了Spotless的google-java-format规则，导致任务创建冲突。

修复步骤： #

1. 检查根项目的build.gradle（或build.gradle.kts），找到Spotless配置块，示例如下：

   spotless {
       java {
           googleJavaFormat() // 全局格式化规则定义
       }
   }
   

2. 查看模块wlcr-auto-api的build.gradle，如果同样存在googleJavaFormat()调用，直接删除该行——模块会自动继承根项目的Spotless规则。
3. 若需模块单独配置格式化规则，可给步骤指定唯一名称避免冲突：

   spotless {
       java {
           googleJavaFormat('模块自定义规则') // 用唯一名称区分全局规则
       }
   }
   

4. 验证修复：执行./gradlew :wlcr-auto-api:spotlessJavaApply，确认任务可正常执行。

二、项目结构正确性检查 #

1. 目录结构验证：确保wlcr-auto-api符合标准Spring Boot/Gradle结构：

   wlcr-auto-api/
   ├── src/
   │   ├── main/
   │   │   ├── java/
   │   │   │   └── [你的包路径]/Application.java // Spring Boot主类
   │   │   └── resources/
   │   └── test/
   └── build.gradle
   

2. settings.gradle检查：确认文件已正确引入模块：

   include ':wlcr-auto-api'
   

3. 模块插件与依赖检查：模块build.gradle需正确配置Spring Boot相关插件：

   plugins {
       id 'java'
       id 'org.springframework.boot' version '你的Spring Boot版本'
       id 'io.spring.dependency-management' version '对应依赖管理版本'
   }
   

三、构建调试方法 #

1. Spotless诊断命令：执行以下命令查看所有配置步骤，准确定位重复项：

   ./gradlew :wlcr-auto-api:spotlessDiagnose
   

2. 临时禁用Spotless：在模块build.gradle中添加spotless.enabled = false，执行./gradlew :wlcr-auto-api:build，验证是否为Spotless之外的问题导致构建失败。
3. 查看详细日志：执行以下命令获取完整错误栈，进一步定位问题：

   ./gradlew :wlcr-auto-api:build --stacktrace
   

4. IntelliJ同步验证：点击Gradle面板的「Sync Project with Gradle Files」按钮，清除IDE缓存，确保IDE识别的结构与Gradle配置一致。

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