Android Studio编译Release版本时Kotlin Poet生成类引发重复声明错误求助

核心原因 #

问题本质是Gradle的sourceSet配置未区分构建变体，导致编译Release时会同时读取Debug版本生成的类文件，反之亦然，触发重复声明错误。

可行解决方案 #

1. 给不同构建变体配置独立的kapt生成目录与sourceSet

在Module级的build.gradle（或build.gradle.kts）中，为Debug和Release分别指定专属的kapt输出目录，同时让每个变体的sourceSet只加载对应目录的生成类：

android {
    buildTypes {
        debug {
            kapt {
                arguments {
                    // 给注解处理器传递输出目录参数，方便Kotlin Poet生成到指定位置
                    arg("KAPT_OUTPUT_DIR", "${project.buildDir}/generated/source/kapt/debug")
                }
            }
            // 让Debug变体只读取自己的生成目录
            sourceSets.debug.java.srcDir("${project.buildDir}/generated/source/kapt/debug")
        }
        release {
            kapt {
                arguments {
                    arg("KAPT_OUTPUT_DIR", "${project.buildDir}/generated/source/kapt/release")
                }
            }
            sourceSets.release.java.srcDir("${project.buildDir}/generated/source/kapt/release")
        }
    }
}

之后在注解处理器中读取KAPT_OUTPUT_DIR参数，用Kotlin Poet把类生成到对应目录下。这样切换变体编译时，只会加载当前变体的生成类，不会交叉读取旧文件。

2. 给不同变体的生成类添加区分标识（备选）

如果不想修改Gradle配置，可以在生成类时，根据构建变体给类名或包名加区分：

• 类名后缀：Debug版本生成YourClassDebug，Release生成YourClassRelease
• 包名区分：Debug类生成到com.yourpackage.debug，Release生成到com.yourpackage.release

实现时需要在build.gradle给kapt传递变体标识，比如arg("BUILD_VARIANT", buildType.name)，然后在Processor中读取这个参数，动态调整类名或包名。

3. 用Gradle变体专属clean任务简化操作

如果暂时不想改配置或生成逻辑，可以用Gradle的变体专属clean任务，编译前自动清理对应变体的生成文件：

• 编译Debug：执行./gradlew cleanDebug assembleDebug
• 编译Release：执行./gradlew cleanRelease assembleRelease

该任务只会清理对应变体的构建产物，不会影响另一个变体的文件，同时避免手动删除的繁琐。

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