Gradle中如何隔离Spotless与应用配置以解决Guava版本冲突？

问题本质 #

ImmutableMap.Builder.buildOrThrow()是Guava 28.0及以后版本才新增的方法，你的项目全局依赖约束强制使用Guava 20.0，导致spotless依赖的google-java-format无法找到该方法，触发NoSuchMethodError。

解决办法：为Spotless配置隔离依赖 #

Gradle支持将插件的运行类路径与应用代码的依赖完全隔离，你可以通过修改build.gradle为spotless单独指定所需的高版本Guava，完全不受全局约束影响：

完整配置示例 #

plugins {
    id 'java'
    id 'com.diffplug.spotless' version '6.25.0' // 建议使用较新的spotless版本
}

// 应用代码的全局依赖约束：必须使用Guava 20.0
allprojects {
    dependencies {
        constraints {
            implementation 'com.google.guava:guava:20.0'
        }
    }
}

spotless {
    java {
        googleJavaFormat()
    }
}

// 关键配置：为spotless插件的运行类路径单独设置依赖规则
buildscript {
    configurations.classpath {
        resolutionStrategy {
            // 强制spotless使用兼容google-java-format的高版本Guava
            force 'com.google.guava:guava:32.1.3-jre'
            // 同步指定google-java-format版本，避免版本不兼容
            force 'com.google.googlejavaformat:google-java-format:1.22.0'
        }
    }
}

配置细节说明 #

• buildscript块负责配置Gradle插件自身的运行环境，和应用代码的依赖是完全隔离的，这里的依赖只会影响插件运行，不会改变应用代码使用的Guava版本。
• resolutionStrategy.force会强制插件类路径使用指定版本的依赖，直接覆盖全局约束的限制。
• 注意版本兼容性：所选Guava版本要和spotless、google-java-format匹配，比如Guava 32.1.3-jre和google-java-format 1.22.0是稳定兼容的组合。

Gradle核心设计逻辑 #

Gradle的依赖体系分成两个独立的类路径：

1. 应用类路径：对应业务代码的编译、运行，dependencies块下的配置和全局约束都作用于这个路径。
2. 构建脚本类路径：对应Gradle插件的运行环境，由buildscript块配置，这个路径和应用类路径完全独立，不受应用依赖规则的限制。

Spotless作为Gradle插件，运行在构建脚本类路径中，所以我们可以通过修改这个路径的依赖规则，为它单独提供高版本Guava，同时保证应用代码继续使用20.0版本。

验证方式 #

执行以下命令测试配置是否生效：

./gradlew spotlessCheck

如果不再抛出NoSuchMethodError，且应用代码编译运行正常，说明配置成功。

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