构建项目时遇错误：无法加载类org.gradle.api.services.BuildService

可能的原因及解决方案： #

• Gradle版本过低：org.gradle.api.services.BuildService是Gradle 6.1及以上版本引入的API，低版本Gradle不支持该类。

  • 修改项目根目录下gradle/wrapper/gradle-wrapper.properties中的distributionUrl，替换为6.1+版本的Gradle包地址，例如：

    distributionUrl=https\://services.gradle.org/distributions/gradle-7.5-bin.zip
    

  • 保存后重新执行构建。

• IDE缓存损坏：IntelliJ IDEA的缓存异常可能导致类加载失败。

  • 点击IDE顶部File → Invalidate Caches...，选择Invalidate and Restart，重启后重新构建项目。

• Gradle本地缓存损坏：本地缓存的Gradle文件可能损坏。

  • 删除本地Gradle缓存目录（默认路径：~/.gradle/caches，Windows为C:\Users\<用户名>\.gradle\caches），然后执行命令：

    ./gradlew clean build  # Linux/macOS
    gradlew.bat clean build  # Windows
    

• 插件版本不兼容：项目使用的Gradle插件依赖更高版本的Gradle API。

  • 检查build.gradle中所有插件的版本，更新至与当前Gradle版本匹配的版本（例如Android插件需与Gradle版本对应）。

报错信息： #

无法加载类 'org.gradle.api.services.BuildService'。
这是一个意外错误，请提交包含idea.log文件的Bug报告。

内容的提问来源于stack exchange，提问作者Ehsan Abid