解决 Gradle 构建错误：Could not get unknown property ‘withoutJclOverSlf4J’

解决 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