如何在Gradle多任务场景下仅运行指定单个任务？

90%以上的单任务执行触发全量逻辑的问题，都是Gradle生命周期理解错误或配置写错导致的，按以下顺序排查即可：

• 首先排查是否把任务执行逻辑写在了配置阶段
  Gradle构建分配置阶段和执行阶段：只要执行任意Gradle命令，所有任务的配置段代码都会在配置阶段运行，和你指定执行哪个任务无关；只有写在doFirst/doLast块里的逻辑，才属于执行阶段，只有任务被显式触发、或被依赖触发时才会运行。
  错误写法示例（所有命令都会触发打印逻辑）：

  task customTaskA {
      // 这段代码在配置段，执行任何gradle命令都会跑
      println "任务A的业务逻辑"
  }
  

  正确写法（仅显式执行gradle customTaskA时才会触发逻辑）：

  task customTaskA {
      doLast {
          // 执行阶段逻辑，仅任务被选中时运行
          println "任务A的业务逻辑"
      }
  }
  

  快速验证方法：执行gradle help，如果原本以为不该运行的任务逻辑依然输出，就属于这个问题。

• 排查任务依赖配置错误
  检查构建脚本里是否存在全局依赖、错误挂载生命周期任务的配置：

  // 错误配置1：给所有任务统一加依赖，会触发全量任务链
  tasks.all {
      dependsOn allCustomTasks
  }
  
  // 错误配置2：把所有自定义任务都挂载到build/assemble等内置生命周期任务上
  build.dependsOn customTaskA, customTaskB, customTaskC // 把10个自定义任务全加在这里了
  

  快速排查方法：执行gradle <你要运行的单任务名> --dry-run，该命令会打印本次执行计划包含的所有任务列表、不会真的执行业务逻辑，顺着输出的依赖链就能找到多余的依赖配置位置。

• 排查本地命令与Jenkins配置问题

  1. 本地执行时确认任务路径正确：如果任务属于子模块，需要写全路径，例如gradle :order-service:deployProd，避免路径匹配错误；
  2. Jenkins如果使用官方Gradle插件，在「Tasks」输入框内仅填写需要执行的单个任务名，清空默认追加的build/clean等附加任务选项，不要留多余参数；
  3. Jenkins如果使用Shell步骤直接调用命令，优先用项目内的Gradle Wrapper执行，命令格式为./gradlew <单任务名> --no-daemon，不要在命令后拼接其他无关任务名。

• 调试技巧
  执行单任务时追加--info参数打印详细日志，能直接看到每个任务的触发原因（是配置阶段执行、还是被其他任务依赖拉起），可以快速定位问题点。

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