Gradle任务排序问题：dependsOn/mustRunAfter/doLast未按预期执行

核心问题定位方向 #

以下是使用dependsOn、mustRunAfter和doLast控制任务顺序时，常见的失效场景及解决方法：

• 依赖关系与顺序约束混淆

  • dependsOn是强依赖：指定任务必须等待依赖任务完成才能执行，Gradle会自动触发依赖任务。
  • mustRunAfter仅为顺序约束：只有当两个任务都被触发时，才保证执行顺序，不会主动触发未关联的任务。
  • 错误示例：任务B配置了mustRunAfter taskA，但B没有dependsOn taskA，且执行时只触发B，此时A不会被执行，顺序约束完全无效。

• doLast的误用

  • doLast属于任务的执行阶段逻辑，是任务的一部分，无法控制任务间的顺序。如果把独立的前置逻辑塞进某个任务的doLast，会导致顺序控制失效。
  • 错误示例：将本该是前置任务的逻辑放在任务A的doLast，再让任务BmustRunAfter A，但实际需求是该逻辑独立于A的主逻辑，此时应拆分为独立任务并配置依赖。

• 任务触发范围不完整

  • 若仅执行目标子任务，且该任务未通过dependsOn关联所有前置任务，前置任务不会被自动触发，自然无法符合预期顺序。比如期望A→B→C，但直接执行C且C未dependsOn B，则B、A都不会执行。

• 约束冲突或循环依赖

  • 当多个mustRunAfter/shouldRunAfter形成循环约束时（如A mustRunAfter B，B mustRunAfter A），Gradle会忽略部分约束，导致顺序混乱。

• 内置任务依赖链干扰

  • 部分内置插件任务（如Java插件的compileJava）有默认依赖链，自定义任务的顺序约束可能被内置依赖覆盖，需检查是否与默认任务序列冲突。

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