You need to enable JavaScript to run this app.
优惠活动
大模型
产品
解决方案
定价
更多

Android Studio报错“Unable to load class 'com.google.common.base.Optional'”求助

解决Android Studio中“Unable to load class 'com.google.common.base.Optional'”报错

这个报错本质是依赖库(Guava)版本不兼容或缓存损坏导致的,以下是经过验证的解决步骤:

  • 检查Android Studio与Gradle版本兼容性
    新版Android Studio对Gradle版本有严格要求,版本不匹配会触发该错误。比如Android Studio Hedgehog(2023.1.1)需要Gradle 8.2及以上版本:

    1. 打开项目根目录的build.gradle(Project级别),更新Android Gradle Plugin版本:
      dependencies {
          classpath "com.android.tools.build:gradle:8.2.0"
      }
      
    2. 修改gradle/wrapper/gradle-wrapper.properties中的Gradle分发地址:
      distributionUrl=https\://services.gradle.org/distributions/gradle-8.2-bin.zip
      

    同步项目后验证问题是否解决。

  • 清理Android Studio缓存
    缓存损坏是常见诱因,直接清理后重启:

    1. 关闭Android Studio
    2. 删除缓存目录:
      • Windows:C:\Users\<你的用户名>\.AndroidStudio<版本号>\system\caches 和 plugins 文件夹
      • Mac:~/Library/Caches/Google/AndroidStudio<版本号>/caches 和 plugins 文件夹
        或者在AS内操作:File > Invalidate Caches... > 勾选Invalidate and Restart
  • 确认JDK配置正确性
    错误涉及的com.google.common.base.Optional类属于Guava库,与JDK版本强相关:

    1. 打开File > Project Structure > SDK Location
    2. 确保JDK location选择Embedded JDK(新版AS默认使用JDK 17,兼容性最佳),避免手动指定低版本JDK
  • 彻底删除全局Gradle缓存
    局部Gradle文件重装可能未清理全局缓存:

    1. 找到全局Gradle缓存目录:
      • Windows:C:\Users\<你的用户名>\.gradle\caches
      • Mac:~/.gradle/caches
    2. 删除该文件夹后,重新打开项目并同步Gradle

内容的提问来源于stack exchange,提问作者Pratheek shetty

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.08.16 23:15:50