Gradle主脚本无法访问子项目扩展属性问题咨询

算力阿峰

2026-5-22

解决Gradle 4.6多模块项目中主脚本访问子项目扩展属性的问题

我之前维护Gradle多模块项目时也踩过这个坑，核心问题其实是Gradle的配置执行顺序在搞鬼，咱们一步步理清楚：

为什么直接访问会失败？

Gradle的构建过程分为「配置阶段」和「执行阶段」：

首先执行根项目的build.gradle里的顶级代码
之后才会逐个执行子项目的build.gradle配置

所以当你在根项目的顶级代码里用allprojects.findAll去查找子项目的ext属性时，子项目的ext { myProp = 'some value' }还没被执行，自然拿不到这个属性。

两种可行的解决方案

1. 延迟到子项目配置完成后再访问（配置阶段）

用afterEvaluate闭包，它会在当前项目（包括子项目）的所有配置代码执行完成后再运行逻辑。在根项目的build.gradle里这么写：

allprojects {
    afterEvaluate { project ->
        // 先判断属性是否存在，避免报错
        if (project.ext.has('myProp')) {
            println "子项目 ${project.name} 的myProp值是：${project.myProp}"
        }
    }
}

这样就能确保子项目的ext属性已经被定义后，再去访问它。

2. 在任务执行阶段访问（更推荐用于业务逻辑）

如果你的需求是在执行某个任务时用到子项目的属性，那把访问逻辑放到任务的doLast（或doFirst）里更合适，因为任务执行阶段是在所有配置完成之后：

// 根项目build.gradle中定义任务
task printSubprojectProps {
    doLast {
        allprojects.each { project ->
            if (project.ext.has('myProp')) {
                println "任务执行时发现：${project.name} -> myProp = ${project.myProp}"
            }
        }
    }
}

运行./gradlew printSubprojectProps就能看到正确的输出了。