Ubuntu 22.04下Gradle安装使用异常求助

以下是针对Error: Could not find or load main class org.gradle.launcher.GradleMain报错的实用解决步骤：

1. 确认Gradle解压完整性 #

首先检查解压后的Gradle目录是否包含完整文件：

ls -l /opt/gradle/gradle-8.0.2

重点查看是否存在lib目录，且目录下有大量.jar文件。如果文件缺失或不全，重新下载Gradle安装包并解压。

2. 验证Java版本兼容性 #

Gradle 8.0.2要求Java 11及以上版本，先检查当前Java版本：

java -version

若版本低于11，安装OpenJDK 11：

sudo apt update && sudo apt install openjdk-11-jdk

设置默认Java版本：

sudo update-alternatives --config java

在弹出的选项中选择对应Java 11的序号。

3. 正确配置环境变量 #

临时的export命令仅对当前终端有效，建议将Gradle路径写入用户配置文件：

• 编辑~/.bashrc文件：

nano ~/.bashrc

• 在文件末尾添加两行：

export GRADLE_HOME=/opt/gradle/gradle-8.0.2
export PATH=$PATH:$GRADLE_HOME/bin

• 保存退出后，让配置立即生效：

source ~/.bashrc

4. 修复目录权限 #

确保当前用户对Gradle目录拥有足够权限：

sudo chown -R $USER:$USER /opt/gradle/gradle-8.0.2

5. 本地脚本直接测试 #

进入Gradle的bin目录直接运行脚本，排查路径问题：

cd /opt/gradle/gradle-8.0.2/bin
./gradle -v

如果此命令成功，说明之前的PATH配置有误；如果仍报错，大概率是安装包损坏，重新下载并校验哈希值后解压。

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