如何检测包含依赖已更新类的类的Gradle项目？

场景还原 #

当前是Monorepo架构下的Gradle多项目结构：

• 项目A：包含类A1，依赖项目D的D1类
• 项目B：包含类B1，和D项目无依赖关系
• 项目C：包含类C1，依赖项目D的D1类
• 项目D：包含类D1，是公共依赖模块
  需求是当D1类更新时，CI流程只构建受影响的A、C、D三个项目，跳过无关的B项目，减少不必要的构建耗时。

实操步骤 #

• 先规范跨项目依赖声明
  所有子项目必须在根目录的settings.gradle里正确注册，跨模块依赖必须用Gradle官方的project方式声明，别硬编码本地jar、或者用其他非标准方式引用，不然Gradle拿不到准确的依赖拓扑，后续分析全错。
  比如项目A的build.gradle里对D的依赖要这么写：

  dependencies {
      implementation project(':D')
  }
  

  项目C同理声明对D的依赖，项目B不要加这个依赖声明。
• 自动识别变更对应的受影响项目
  直接结合Git变更记录+Gradle自带的依赖分析能力就行，不用手动维护静态映射表：
  1. CI流程拉取代码后，先通过Git diff拿到当前提交/PR对比基线分支（一般是main/master）的所有变更文件列表
  2. 遍历变更文件先定位每个文件所属的子项目，再顺着Gradle的依赖拓扑反向查找所有依赖这个子项目的上游项目，去重后就是完整的待构建项目集合
     核心逻辑参考：

  # 拿到和主分支对比的所有变更文件
  CHANGED_FILES=$(git diff --name-only origin/main...HEAD)
  # 调用自定义Gradle任务解析受影响项目
  AFFECTED_PROJECTS=$(./gradlew findAffectedProjects -PchangedFiles="$CHANGED_FILES" | tail -1)
  

  这里的findAffectedProjects是个轻量自定义任务，逻辑就是遍历所有子项目的依赖关系，匹配变更文件所属项目后输出所有关联的上游项目，十几行Gradle代码就能实现，不需要额外引入第三方插件。
• 执行定向构建
  拿到受影响的项目列表后，直接给Gradle传对应项目的构建任务即可，比如最终识别到要构建D、A、C三个项目，直接执行：

  ./gradlew :D:build :A:build :C:build
  

  执行过程会完全跳过项目B的构建、测试、打包流程，构建耗时会明显缩短。

常见避坑点 #

• 别手动维护项目依赖关系表，只要过几个迭代肯定和实际代码不一致，漏构建是早晚的事，一定要基于Gradle实时解析的依赖拓扑做判断
• 如果项目里用了注解处理器、字节码插桩这类逻辑，记得把对应配置文件、插件脚本也纳入变更检测范围，不然改了构建逻辑没触发对应项目构建很容易出问题
• 开了Gradle构建缓存的场景下，只要变更输入检测逻辑做对，缓存会自动失效，不需要额外加参数强制跳过缓存，不要做多余操作。

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