缓存键变化导致构建变慢或命中率低，根本原因是构建输入不稳定，如JDK路径、环境变量、动态版本等导致Gradle判定构建不同而拒绝复用缓存。
缓存键变化导致构建变慢或命中率低
Gradle缓存键（cache key）不是固定不变的，只要构建输入有细微差异，就会生成新键、跳过缓存。最典型的表现是：同一份代码，不同人构建、或同一人在不同时间构建，org.gradle.caching=true开启后仍几乎不命中，Build cache entry not found频繁出现。这不是缓存损坏，而是输入不稳定——Gradle认为“这次构建和上次不一样”，所以拒绝复用。
检查哪些输入项实际在变
Gradle缓存键由任务输入（inputs）决定，包括源码、依赖坐标、JVM参数、环境变量、甚至系统时间戳。排查要从具体任务入手，不能只看全局配置。
- 运行
./gradlew assembleDebug --scan，打开生成的 Build Scan 页面，在「Tasks」里点开某个耗时任务 → 查看「Inputs」展开项，重点关注标红或带「changed」标记的字段 - 常见易变项：
java.home（不同JDK路径）、org.gradle.jvmargs（内存参数含空格或换行）、user.name或os.name（某些插件会读取）、build.time（自定义task里用了new Date()） - Android项目特别注意：
android.useAndroidX、android.enableJetifier这类布尔值若在gradle.properties里没显式声明，默认值可能因AGP版本而异，造成键漂移
buildSrc 或 Kotlin DSL 脚本里的时间/随机逻辑
很多团队在buildSrc里写动态逻辑，比如根据当前Git分支名生成versionName，或用System.currentTimeMillis()打时间戳。这些值每次执行都不同，直接污染整个构建图的缓存键。
- 检查所有
buildSrc/src/main/kotlin/**/*.kt文件，搜索System.、Date()、Random、UUID等关键词 - 把非确定性逻辑移到
tasks.register内部（仅影响该task），而不是在配置阶段（影响整个project） - 若必须用时间戳，改用固定值（如CI环境里的
CI_PIPELINE_ID）或哈希摘要（如git rev-parse HEAD输出）代替实时计算
依赖版本未锁定导致坐标波动
用1.2.+或latest.release这类动态版本，会让implementation声明的坐标随远程仓库内容变化而变化，缓存键自然不同。
- 运行
./gradlew app:dependencies --configuration debugCompileClasspath，对比两次构建输出，看是否有版本号浮动（如com.example:lib:1.2.3→com.example:lib:1.2.4） - 启用
dependencyLocking：在gradle.properties加org.gradle.configuration-cache.problems=warn，再执行./gradlew --write-locks生成gradle/locks/下锁文件 - 避免在
buildscript { dependencies }里用动态版本，classpath依赖更需严格锁定
System.getenv("USER")换成硬编码字符串，也可能让命中率从5%升到90%。 
