如何使用Gradle在自定义Jar任务中引入指定构件并解决报错

触发异常的核心原因有两点：

• 你在Gradle配置阶段直接通过getByName实例化shadowJar任务，并尝试读取archiveFile的实际值。该属性是懒加载类型，只有shadowJar任务执行完成后才能生成具体文件路径，配置阶段强制查询必然报错。
• 直接将archiveFile属性传入依赖配置时，Gradle无法自动识别该属性和shadowJar任务的依赖关系，不会自动安排shadowJar任务优先执行。

方案1：无需修改被依赖模块，直接声明懒加载依赖 #

用named替代getByName获取懒加载的任务提供者，通过files包装任务产出的文件Provider，让Gradle自动追踪任务依赖，不会提前解析文件路径：

runtimeOnly(
    files(
        project(":project1").tasks.named<Jar>("shadowJar").flatMap { it.archiveFile }
    )
)

这种写法会在依赖解析阶段自动触发shadowJar任务执行，等任务完成后才会读取jar包实际路径，完全符合Gradle懒加载规范。

方案2：规范做法，在被依赖模块声明自定义构件（多模块场景推荐） #

如果有多个模块需要依赖这个shadowJar产出，推荐在:project1模块内把shadowJar注册为对外暴露的独立构件，避免消费端代码直接耦合生产端的任务名：

1. 首先在:project1的build.gradle.kts中添加自定义可消费配置和构件声明：

plugins {
    `java-library`
    id("com.github.johnrengelman.shadow")
}

// 定义专门暴露shadow fatjar的可消费配置
val shadowJarElements by configurations.creating {
    isCanBeConsumed = true
    isCanBeResolved = false
    attributes {
        attribute(Category.CATEGORY_ATTRIBUTE, objects.named(Category.LIBRARY))
        attribute(Bundling.BUNDLING_ATTRIBUTE, objects.named(Bundling.SHADOWED))
    }
}

// 将shadowJar任务产出注册为该配置的对外构件
artifacts {
    add(shadowJarElements.name, tasks.named("shadowJar"))
}

2. 在消费端直接依赖对应配置即可，不需要感知生产端的任务逻辑：

runtimeOnly(project(":project1", "shadowJarElements"))

• 所有配置阶段引用任务的场景，优先用named返回TaskProvider，不要直接用getByName/getByPath立刻实例化任务，避免破坏Gradle懒加载机制拖慢构建速度。
• 不要在配置阶段调用get()、getOrNull()等方法解析Provider类型属性，这类属性的值只有在执行阶段对应任务完成后才会生成。

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