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