Windows配置Grails时出现Classpath错误求助

我碰到过不少用Grails 3.x的开发者遇到这个问题，核心就是Gradle没法顺利获取org.grails:grails-gradle-plugin:3.3.4这个核心依赖。结合你的环境（Win10 x64、JDK 1.8.0_141），给你几个针对性的解决办法：

1. 替换Gradle仓库源，优先用国内镜像 #

默认的Maven仓库在国内访问经常不稳定，你可以修改项目根目录下的build.gradle文件，把仓库换成国内镜像（比如阿里云），这样拉取依赖速度快很多：
打开项目根目录的build.gradle，找到repositories代码块，修改成如下内容：

repositories {
    mavenLocal()
    maven { url "https://maven.aliyun.com/repository/public" }
    mavenCentral()
    maven { url "https://repo.grails.org/grails/core" }
}

修改完保存，再重新运行grails run-app试试。

2. 清理Gradle本地缓存，排除损坏文件 #

有时候本地缓存的依赖文件损坏会导致解析失败，手动清理缓存就能解决：

• 打开文件资源管理器，输入%USERPROFILE%\.gradle\caches，回车进入缓存目录
• 删除这个目录下的所有文件和文件夹（不用担心，后续会自动重新下载需要的依赖）
• 回到项目根目录，重新执行启动命令

3. 确认JDK版本配置完全正确 #

虽然你已经安装了JDK 1.8.0_141，但要确保Grails和Gradle都能正确识别到这个版本：

• 打开命令提示符，输入java -version和javac -version，确认输出都是1.8.0_141
• 检查项目根目录的gradle.properties文件，如果没有就新建一个，添加JDK路径配置：

org.gradle.java.home=C:\\Program Files\\Java\\jdk1.8.0_141

注意路径里的反斜杠要写成双反斜杠，或者用正斜杠代替。

4. 重新验证Grails安装完整性 #

有时候安装包损坏也会导致这类问题，你可以重新安装Grails试试：

• 卸载当前的Grails 3.3.4，清理掉GRAILS_HOME对应的目录
• 从Grails官方归档页面下载对应版本的安装包，记得校验文件的MD5/SHA值确保完整性
• 重新解压后配置GRAILS_HOME和PATH环境变量，运行grails -version确认版本正确，再重新创建项目测试

额外提示：如果是公司网络有代理，需要给Gradle配置代理信息。在%USERPROFILE%\.gradle\gradle.properties文件中添加以下内容（替换成你的代理信息）：

systemProp.http.proxyHost=你的代理地址
systemProp.http.proxyPort=代理端口
systemProp.https.proxyHost=你的代理地址
systemProp.https.proxyPort=代理端口

如果代理需要账号密码，再加上systemProp.http.proxyUser=你的账号和systemProp.http.proxyPassword=你的密码即可。

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