
当使用 `filetree` 或 `files()` 声明本地 jar 依赖时,gradle 的 `dependencies` 任务默认不显示这些文件依赖;需通过自定义任务遍历 `configurations.*` 集合并显式输出路径或名称。
在 Gradle 中,通过 files()、fileTree() 等方式引入的本地文件依赖(即非坐标化依赖)不会被 ./gradlew :project:dependencies 任务识别为“依赖项”,因为它们不属于 Maven/Ivy 仓库体系,也不具备模块坐标(group:name:version),因此该任务仅展示传递性依赖图,对纯文件路径依赖返回 No dependencies。
要真正查看 infraLibs(或其他自定义 configuration)中实际包含的本地 JAR 文件,最直接有效的方式是定义一个专用的 Gradle 任务,手动遍历对应 configuration 的文件集合:
task printInfraLibs {
doLast {
configurations.infraLibs.resolvedConfiguration.files.each { file ->
println "→ ${file.name} [${file.absolutePath}]"
}
}
}✅ 推荐使用 resolvedConfiguration.files(而非 configurations.infraLibs.each),因为它确保所有依赖(包括嵌套 fileTree 和 files() 声明)均已解析完成,且返回的是 File 实例,可安全访问路径与名称。
执行命令:
./gradlew printInfraLibs
你将看到类似输出:
→ aspectjrt-1.9.20.jar [/path/to/lib/aspectj-1.9.20/aspectjrt-1.9.20.jar] → aspectjtools-1.9.20.jar [/path/to/lib/aspectj-1.9.20/aspectjtools-1.9.20.jar] → log4j-api-2.17.1.jar [/path/to/lib/log4j-2.17.1/log4j-api-2.17.1.jar] → commons-lang-2.6.jar [/path/to/lib/commons-lang-2.6/commons-lang-2.6.jar] → commons-beanutils.jar [/path/to/lib/commons-beanutils-1.9.4/commons-beanutils.jar]
⚠️ 注意事项:
- 确保 infraLibs configuration 已正确定义(如 configurations.create("infraLibs")),并在 dependencies 块中正确赋值;
- 若在 doLast 中直接访问 configurations.infraLibs.files,可能因延迟解析导致空结果;务必使用 resolvedConfiguration.files;
- 在 Gradle 7.0+ 中,推荐使用 configurations.infraLibs.incoming.artifacts.files(面向新依赖管理 API),但对纯文件依赖兼容性仍以 resolvedConfiguration 最稳定;
- 如需导出为文本文件,可在任务中追加:new File("infraLibs-deps.txt").text = configurations.infraLibs.resolvedConfiguration.files.join("\n")
总结:本地 JAR 不参与标准依赖图渲染,但可通过编程式遍历 resolvedConfiguration.files 完全可控地审计、验证和调试实际参与构建的二进制文件——这是处理离线/封闭环境项目的必备实践。











