使用Gradle共享只读依赖缓存时编译缓慢的原因排查

一、两个文件的内容 #

• jarAnalysis.bin：存储Gradle对项目依赖JAR包的预分析结果，包含JAR内的类结构、依赖关系、注解信息、成员可访问性等元数据。Gradle会提前扫描所有依赖JAR，将这些信息序列化到该二进制文件中。
• classAnalysis.bin：存储对项目编译生成类文件的分析结果，涵盖类的继承关系、接口实现、方法签名、注解、字节码特征等，是Gradle实现增量编译、依赖追踪的核心数据载体。

二、对编译时长影响巨大的原因 #

1. 避免重复扫描解析
   当这两个文件缺失时，Gradle编译阶段需要重新遍历所有依赖JAR包，逐个解析类文件字节码以提取元数据——这个过程在依赖较多的项目中CPU和磁盘IO开销极大，尤其是CI环境下首次处理远程拉取的依赖时，耗时会非常突出。
2. 支撑增量编译逻辑
   这两个文件是Gradle增量编译的基础：它们让Gradle能快速判断类的变更范围、依赖类修改的影响面，无需每次全量扫描所有类文件。缺失时，Gradle无法复用已有分析结果，只能执行全量类分析，直接拉长编译时间。
3. CI环境的场景放大效应
   CI环境通常是干净构建环境（你测试时清空$GRADLE_HOME就是典型场景），没有本地缓存的分析数据，重新生成这些结果需要遍历大量JAR和类文件；而预填充后直接复用序列化的二进制数据，跳过了最耗时的扫描解析步骤，因此时间差异会非常明显。

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