如何在Jenkins Pipeline中检查Gradle子项目是否存在？

针对你这种大型Gradle项目且无法修改构建逻辑的场景，我推荐两种更高效的方式，比解析gradle projects输出更可靠：

方案一：利用Gradle Settings阶段快速查找（推荐） #

这个方法直接借助Gradle原生的项目查找API，在Settings阶段执行（无需配置所有子项目，速度极快），完全不需要解析复杂的输出文本，准确性拉满。

在Jenkins Pipeline里可以封装成一个工具函数：

def doesSubprojectExist(String targetProjectPath) {
    // 调用Gradle脚本在Settings阶段查找项目
    def checkResult = sh(
        script: """
            gradle -q -PtargetProj="$targetProjectPath" << 'EOF'
            settingsEvaluated { settings ->
                // 用Gradle原生API查找项目路径
                def found = settings.findProject(targetProj) != null
                println found ? "TRUE" : "FALSE"
            }
            EOF
        """,
        returnStdout: true
    ).trim()
    
    return checkResult == "TRUE"
}

使用示例 #

def target = ":moduleA:subModuleB:deepNestedModuleC"
if (doesSubprojectExist(target)) {
    echo "子项目 $target 存在，执行构建任务..."
    sh "./gradlew $target:build"
} else {
    echo "子项目 $target 不存在，跳过相关任务"
}

为什么这个方案更好？ #

• 性能优异：只在Settings阶段执行，不会触发子项目的构建脚本配置，对于数万行Gradle脚本的大型项目来说，速度比解析projects输出快得多
• 准确可靠：依赖Gradle自身的findProject API，不管子项目嵌套多少层（4-5级完全没问题），或者用了include/includeFlat等复杂配置，都能正确识别
• 无侵入：完全不需要修改项目的任何Gradle脚本，符合你不能改动构建逻辑的要求

方案二：轻量解析gradle projects输出（适合快速验证） #

如果你觉得写Gradle内嵌脚本有点麻烦，也可以用grep快速匹配输出，但要注意正则的准确性（适配Gradle的输出格式）：

def doesSubprojectExist(String targetProjectPath) {
    // 调用gradle projects并匹配目标项目行
    def exitCode = sh(
        script: "gradle -q projects | grep -E '^\\s*Project \\'$targetProjectPath\\''",
        returnStatus: true
    )
    // grep找到匹配项返回0，否则返回非0
    return exitCode == 0
}

注意事项 #

• 这个方案需要Gradle完成所有子项目的配置才能输出完整的项目列表，对于超大型项目来说速度会慢一些
• 依赖Gradle的projects命令输出格式，如果Gradle版本升级导致输出格式变化，可能需要调整正则表达式

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