Apollo Kotlin 4.1.1版本构建失败问题分析与解决方案

问题现象

在使用Apollo Kotlin 4.1.1版本时，开发者在构建过程中遇到了一个特定错误。当项目中任何模块应用了Apollo插件时，构建过程都会失败，并显示如下错误信息：

Cannot set the value of task ':audit-log-data:generateServiceApolloSources' property 'apolloBuildService' of type com.apollographql.apollo.gradle.internal.ApolloBuildService

问题根源分析

这个问题的本质是Gradle类加载器冲突导致的。具体来说，当项目使用buildSrc来管理构建逻辑时，Apollo插件的类被不同的类加载器加载了两次：

1. 第一次是通过buildSrc的类加载器加载
2. 第二次是通过项目主构建脚本的类加载器加载

这导致Gradle无法识别这两个类加载器加载的ApolloBuildService类是相同的类型，因此在尝试设置任务属性时抛出类型不匹配的异常。

解决方案

要解决这个问题，需要确保Apollo插件只通过buildSrc加载一次。具体步骤如下：

1. 在buildSrc/build.gradle.kts文件中明确声明Apollo插件的依赖：

implementation("com.apollographql.apollo:apollo-gradle-plugin:4.1.1")

2. 在各个子模块的构建脚本中应用插件时，不要指定版本号：

plugins {
    id("com.apollographql.apollo")
}

技术背景

这个问题实际上反映了Gradle构建系统中的一个已知问题。当使用buildSrc时，Gradle会为buildSrc创建一个独立的类加载器。如果插件同时在buildSrc和主构建脚本中被加载，就会导致同一个类被不同的类加载器加载，从而引发类型不匹配的问题。

Apollo Kotlin插件在4.1.1版本中引入了一个内部服务ApolloBuildService，这个服务需要在任务之间共享。当类加载器不一致时，Gradle无法正确识别服务实例的类型兼容性，从而导致构建失败。

最佳实践建议

为了避免类似问题，在使用buildSrc管理构建逻辑时，建议：

1. 将所有插件依赖集中声明在buildSrc中
2. 避免在主构建脚本中重复声明插件版本
3. 定期检查Gradle和插件的兼容性
4. 保持buildSrc和主项目的Gradle版本一致

总结

Apollo Kotlin 4.1.1版本在特定构建配置下出现的这个构建失败问题，本质上是Gradle类加载机制与插件架构交互产生的结果。通过统一插件的加载来源，可以避免类加载器冲突，确保构建过程顺利进行。这个问题也提醒我们，在使用buildSrc等高级Gradle特性时，需要特别注意依赖管理的统一性。