Gradle怎么让CI和本地共享构建缓存-java教程-PHP中文网

必须配置org.gradle.caching=true才能启用Gradle远程构建缓存，否则本地与CI缓存完全隔离；--build-cache仅为临时覆盖，不可替代该配置；远程缓存须用HTTP服务（如Gradle Enterprise或Build Cache Node），禁用NFS；push需按环境控制，本地默认false，CI设true；输入指纹一致性（源码路径、依赖版本、JDK版本）决定缓存复用能力；命中率低需检查Task Inputs中非确定性值。

gradle怎么让ci和本地共享构建缓存

CI和本地共用远程构建缓存必须配`org.gradle.caching=true`

不启用这个开关，Gradle根本不会尝试读写远程缓存——本地和CI各自走各自的本地缓存，完全隔离。它不是“默认开启”的功能，必须显式配置。

常见错误是只在CI脚本里加了--build-cache参数，但没在gradle.properties里设org.gradle.caching=true，结果CI能push但本地拉不到；或者反过来，本地启用了却没给CI配远程地址，导致CI生成的缓存全丢在本地磁盘上。

org.gradle.caching=true 是全局开关，控制是否参与构建缓存机制
--build-cache 只是命令行临时覆盖，不能替代配置项
CI环境建议额外加--no-daemon避免守护进程干扰缓存命中判断

远程缓存服务选型：推荐用Gradle Enterprise或自建`Build Cache Node`

别用NFS或共享目录模拟远程缓存——Gradle的缓存协议不是简单文件拷贝，它依赖原子性写入、哈希校验和并发安全的GET/PUT语义。用HTTP服务是最稳的选择。

Gradle官方推荐两种落地方式：

商用方案：Gradle Enterprise，开箱即用，带命中率看板和失效分析，适合中大型团队
开源自建：Build Cache Node（基于Spring Boot），部署轻量，支持Basic Auth，CI用curl就能推送

配置示例（settings.gradle.kts）：

buildCache {
    remote<httpbuildcache> {
        url = uri("https://cache.your-company.com/cache/")
        credentials {
            username = "gradle-cache"
            password = System.getenv("GRADLE_CACHE_TOKEN") ?: ""
        }
        push = providers.gradleProperty("gradle.cache.push").getOrElse("false").toBoolean()
    }
}</httpbuildcache>

注意：push必须按环境控制——本地默认false，CI流水线才设为true，否则开发机误推脏缓存会污染整个团队。