解决 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”的错误。

---

错误原因

出现此错误的主要原因有以下几点：

1. 属性未定义
   withoutJclOverSlf4J 是一个自定义属性，通常用于在添加依赖时对传递依赖进行排除。但如果在构建脚本中没有对其进行定义，Gradle 就无法识别这个属性，进而报错。
2. 加载顺序问题
   如果该属性定义在某个配置文件中，但加载顺序不对，导致在使用该属性时尚未定义，也会出现类似问题。
3. 拼写或作用域错误
   如果属性名称拼写错误，或者定义的作用域不正确，也会导致 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