解决 Gradle 构建错误：Could not get unknown property ‘withoutJclOverSlf4J’
在构建 Spring 源码或其他基于 Gradle 的项目时，可能会遇到如下错误：
Could not get unknown property 'withoutJclOverSlf4J' for object of type org.gradle.api.internal.artifacts.dsl.dependencies.DefaultDependencyHandler.
本文将详细解析该错误的原因，并介绍如何处理此问题。
错误解析
该错误信息表明，在项目的某个 Gradle 构建脚本中，尝试使用名为 withoutJclOverSlf4J 的属性，但 Gradle 在当前依赖处理器（DependencyHandler）中找不到这个属性。
例如，在某处依赖声明中可能存在类似下面的代码：
testCompile("org.apache.tiles:tiles-core:${tiles3Version}", withoutJclOverSlf4J)
这行代码的意思是，在添加 tiles-core 依赖时，额外传入一个配置参数 withoutJclOverSlf4J，目的是排除某些传递依赖（通常是为了排除日志桥接库 jcl-over-slf4j）。然而，如果没有在项目中定义该属性，就会导致 Gradle 报出“unknown property”的错误。
错误原因
出现此错误的主要原因有以下几点：
- 属性未定义
withoutJclOverSlf4J是一个自定义属性，通常用于在添加依赖时对传递依赖进行排除。但如果在构建脚本中没有对其进行定义，Gradle 就无法识别这个属性，进而报错。 - 加载顺序问题
如果该属性定义在某个配置文件中，但加载顺序不对，导致在使用该属性时尚未定义，也会出现类似问题。 - 拼写或作用域错误
如果属性名称拼写错误，或者定义的作用域不正确，也会导致 Gradle 找不到该属性。
处理方式
1. 定义 withoutJclOverSlf4J 属性
解决该问题的最直接方法是在项目的根 build.gradle 文件中使用 ext 块定义该属性。例如：
ext.withoutJclOverSlf4J = { dependency ->dependency.exclude group: "org.slf4j", module: "jcl-over-slf4j"
}
这样定义后，在引用该属性时（例如在 testCompile 声明中），Gradle 就能够正确执行闭包，排除 jcl-over-slf4j 模块。
2. 检查加载顺序
确保上述定义在所有子项目加载之前就已执行。可以将该定义放在根项目的最前面，或者单独放到一个公共的配置文件中，然后在 settings.gradle 或根 build.gradle 中提前加载。
3. 检查拼写和作用域
- 拼写：确保在定义时和引用时名称完全一致（大小写敏感）。
- 作用域：如果你在子项目中引用此属性，请确保该属性在根项目中定义后，可以在子项目中访问到。
总结
错误 “Could not get unknown property ‘withoutJclOverSlf4J’” 的根本原因在于在依赖声明中使用了一个未定义的自定义属性。解决方法如下：
-
在根
build.gradle文件中定义withoutJclOverSlf4J，例如：ext.withoutJclOverSlf4J = { dependency ->dependency.exclude group: "org.slf4j", module: "jcl-over-slf4j" } -
确保该属性定义在所有子项目加载之前。
-
检查属性名称是否正确且在整个项目中保持一致。
通过以上方法，Gradle 就能正确识别并使用 withoutJclOverSlf4J 属性，从而避免构建报错。希望这篇文章对你解决问题有所帮助！
参考资料：
blog.csdn.net
