Gradle项目apply from拆分独立任务文件时报org属性未知错误

这个问题的核心是Gradle的类加载作用域隔离机制：

• 你在根目录build.gradle的plugins块中引入的OpenAPI Generator插件，其所有内部类（比如任务类型GenerateTask）都托管在插件专属的类加载器中
• 通过apply from加载的外部拆分脚本，拥有独立的脚本类加载器，默认无法跨作用域访问插件专属类加载器中的类
• 当外部脚本执行到type: org.openapitools.generator.gradle.plugin.tasks.GenerateTask这行代码时，因为类路径中找不到这个类，Groovy脚本会将org识别为当前Project对象的属性尝试读取，最终触发“无法获取未知属性'org'”的报错
• 而当你把全部配置写在根build.gradle中时，脚本和插件处于同一个类加载作用域，可以正常访问插件提供的任务类型，因此构建不会报错

方案1：分离任务类型定义与属性配置（推荐，无额外依赖） #

1. 在根目录build.gradle的plugins块、apply from语句之前，完成任务的类型注册（此时脚本可以正常访问插件类）：

plugins {
  id 'org.openapi.generator' version '4.3.1'
}

// 在apply from 之前注册任务类型
tasks.register('buildSampleClient', org.openapitools.generator.gradle.plugin.tasks.GenerateTask)

apply from: "$projectDir/gradle/script/openapi.gradle"

2. 调整独立脚本gradle/script/openapi.gradle的内容，删除重复的任务类型声明，仅通过任务名获取已注册的任务并配置属性：

// 仅配置已注册的任务属性
tasks.named('buildSampleClient') {
    generatorName = "spring"
    inputSpec = "$rootDir/src/main/resources/sample.yaml".toString()
    outputDir = "$buildDir/generated".toString()
    modelPackage = "com.sample"
}

方案2：给外部脚本补充插件类路径 #

如果一定要在外部拆分脚本中完整定义任务类型，可以在外部脚本的最开头，通过buildscript块将OpenAPI Generator插件添加到该脚本的类加载路径中：

// gradle/script/openapi.gradle 完整内容
buildscript {
    repositories {
        gradlePluginPortal()
    }
    dependencies {
        classpath 'org.openapitools:openapi-generator-gradle-plugin:4.3.1'
    }
}

// 原有任务定义逻辑保持不变
task buildSampleClient(type: org.openapitools.generator.gradle.plugin.tasks.GenerateTask) {
    generatorName = "spring"
    inputSpec = "$rootDir/src/main/resources/sample.yaml".toString()
    outputDir = "$buildDir/generated".toString()
    modelPackage = "com.sample"
}

注意：方案2会重复加载一次插件类，存在类版本不一致的潜在风险，因此优先推荐方案1的拆分方式。

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