执行groovy -v报错：找不到或无法加载主类org.codehaus.groovy.tools.GroovyStarter

问题复现 #

执行groovy -v时抛出错误：

Error: Could not find or load main class org.codehaus.groovy.tools.GroovyStarter
Caused by: java.lang.ClassNotFoundException: org.codehaus.groovy.tools.GroovyStarter

环境信息：

• Java版本：openjdk version "17.0.6" 2023-01-17 LTS（微软OpenJDK）
• Groovy版本：4.0.8（从jfrog.io获取的apache-groovy-binary-4.0.8.zip）
• 已配置JAVA_HOME、GROOVY_HOME环境变量并添加至系统路径，Groovy解压路径：C:\Users<Myusername>\dev\languages\apache-groovy-sdk-4.0.8\groovy-4.0.8\bin

排查与解决步骤 #

• 修正GROOVY_HOME路径
  确保GROOVY_HOME指向Groovy根目录而非bin目录，正确路径应为：C:\Users<Myusername>\dev\languages\apache-groovy-sdk-4.0.8\groovy-4.0.8；系统Path中添加%GROOVY_HOME%\bin而非直接指向bin目录。
• 检查Groovy包完整性
  确认解压后的Groovy目录下lib文件夹包含groovy-4.0.8.jar等核心依赖包，若缺失则重新下载完整二进制包解压。
• 验证环境变量生效
  修改环境变量后关闭并重新打开终端，执行echo %GROOVY_HOME%和echo %JAVA_HOME%确认路径正确。
• 直接测试核心类
  在Groovy根目录下执行命令：

  java -cp lib/* org.codehaus.groovy.tools.GroovyStarter --version
  

  若能正常输出版本，说明Path中Groovy路径优先级或配置仍有问题，需重新检查。

额外提示 #

若上述步骤无效，可尝试清理系统中旧版本Groovy的残留环境变量，或以管理员身份打开终端执行命令。

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