Debian 11环境下Gradle启动失败求助：无法切换目录及主类找不到

问题详情 #

• 系统环境：Debian 11 Bullseye

  Linux debian 5.10.0-23-amd64 #1 SMP Debian 5.10.179-2 (2023-07-14) x86_64 GNU/Linux
  

• 触发场景：安装最新版Gradle后，执行gradle命令测试可用性时出现错误：

  /bin/gradle: 23: cd: can't cd to /bin/../share/gradle/bin/..
  Error: Could not find or load main class org.gradle.launcher.GradleMain
  Caused by: java.lang.ClassNotFoundException: org.gradle.launcher.GradleMain
  

• 已尝试操作：降级Gradle、重新声明PATH变量，问题未解决

可行解决方法 #

1. 修复Gradle安装路径问题 #

错误提示的路径跳转失败，说明安装目录结构不完整或软链接失效，按以下步骤重新安装：

• 卸载现有Gradle：

  sudo apt remove --purge gradle
  

• 手动下载官方二进制包（替换为对应版本号）并解压：

  sudo mkdir -p /opt/gradle
  sudo unzip gradle-8.4-bin.zip -d /opt/gradle
  

• 创建系统级软链接：

  sudo ln -s /opt/gradle/gradle-8.4/bin/gradle /usr/bin/gradle
  

• 验证：

  gradle -v
  

2. 检查Java版本兼容性 #

Gradle不同版本对Java版本有要求（如Gradle 8.x需Java 11+）：

• 查看当前Java版本：

  java -version
  

• 若版本过低，安装适配的OpenJDK：

  sudo apt install openjdk-17-jdk
  

• 设置默认Java版本：

  sudo update-alternatives --config java
  

3. 清理Gradle缓存 #

缓存损坏也可能导致启动异常：

• 删除用户缓存目录：

  rm -rf ~/.gradle/caches
  

• 再次运行测试命令：

  gradle -v
  

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