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及以上版本:- 打开项目根目录的
build.gradle(Project级别),更新Android Gradle Plugin版本:dependencies { classpath "com.android.tools.build:gradle:8.2.0" } - 修改
gradle/wrapper/gradle-wrapper.properties中的Gradle分发地址:distributionUrl=https\://services.gradle.org/distributions/gradle-8.2-bin.zip
同步项目后验证问题是否解决。
- 打开项目根目录的
清理Android Studio缓存
缓存损坏是常见诱因,直接清理后重启:- 关闭Android Studio
- 删除缓存目录:
- Windows:
C:\Users\<你的用户名>\.AndroidStudio<版本号>\system\caches和plugins文件夹 - Mac:
~/Library/Caches/Google/AndroidStudio<版本号>/caches和plugins文件夹
或者在AS内操作:File > Invalidate Caches... > 勾选Invalidate and Restart
- Windows:
确认JDK配置正确性
错误涉及的com.google.common.base.Optional类属于Guava库,与JDK版本强相关:- 打开
File > Project Structure > SDK Location - 确保
JDK location选择Embedded JDK(新版AS默认使用JDK 17,兼容性最佳),避免手动指定低版本JDK
- 打开
彻底删除全局Gradle缓存
局部Gradle文件重装可能未清理全局缓存:- 找到全局Gradle缓存目录:
- Windows:
C:\Users\<你的用户名>\.gradle\caches - Mac:
~/.gradle/caches
- Windows:
- 删除该文件夹后,重新打开项目并同步Gradle
- 找到全局Gradle缓存目录:
内容的提问来源于stack exchange,提问作者Pratheek shetty
相关产品推荐
相关产品推荐

