Gradle Java项目增量构建失败，请求技术排查指导

1. 开启非public API依赖追踪 #

Gradle默认只追踪类之间的public API依赖，当代码访问其他类的非public成员时，增量编译会漏掉这种依赖关系，导致报错。你可以在构建脚本里配置JavaCompile任务，强制Gradle检测所有成员的依赖：

Groovy DSL（build.gradle）

tasks.withType(JavaCompile) {
    // 可选：开启编译告警，方便排查潜在问题
    options.compilerArgs.add('-Xlint:all')
    // 让编译任务依赖主源码集的输出，确保非public成员依赖被追踪
    dependencies {
        implementation sourceSets.main.output
    }
}

Kotlin DSL（build.gradle.kts）

tasks.withType<JavaCompile> {
    options.compilerArgs.add("-Xlint:all")
    dependencies {
        implementation(sourceSets.main.get().output)
    }
}

这个配置会让Gradle在增量构建时，正确识别GuiFrame对AbstractRibbonBand非public成员的依赖，触发必要的编译步骤。

2. 验证源集配置 #

确认AbstractRibbonBand.java和GuiFrame.java都在同一个源集（默认src/main/java）下。如果分属不同源集，要确保使用方的源集依赖提供方的源集输出，比如：

// 假设GuiFrame在custom源集，AbstractRibbonBand在main源集
sourceSets {
    custom {
        java.srcDirs = ['src/custom/java']
        dependencies {
            implementation sourceSets.main.output
        }
    }
}

3. 清理缓存（临时修复） #

如果配置后还是有问题，先清理Gradle的构建缓存和增量编译状态，强制重新生成依赖关系：

./gradlew clean --no-build-cache

之后再尝试增量构建，看是否恢复正常。

4. 调整访问权限（根治方案） #

从代码设计角度，尽量避免直接访问其他类的非public成员。可以把ribbonTask改为protected，或者给AbstractRibbonBand添加public的访问方法（比如getRibbonTask()），这样既符合Java封装原则，也能让Gradle默认的增量编译逻辑正常工作，从根源上避免这类问题。

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