在Liferay IDE中用Gradle创建Liferay7模块项目时遭遇构建异常

我之前在Liferay IDE里用Gradle创建7.x模块项目时，也踩过这个org.gradle.tooling.BuildException的坑，通常和Gradle版本适配、IDE配置或者网络问题有关，给你几个实用的排查和解决步骤：

1. 检查Gradle版本兼容性 #

Liferay 7.x对Gradle版本有明确要求，比如Liferay DXP 7.0/7.1通常推荐使用Gradle 4.x，但部分特定版本的Liferay需要更匹配的Gradle版本：

• 打开项目根目录的gradle/wrapper/gradle-wrapper.properties文件，确认distributionUrl指向的版本是否和Liferay官方文档要求一致（比如Liferay 7.1更适配gradle-4.10.3-all.zip而非4.0）。
• 若版本不匹配，修改distributionUrl后，执行./gradlew clean build --refresh-dependencies（Windows系统用gradlew.bat）刷新依赖。

2. 修复IDE的Gradle配置 #

有时候Liferay IDE自带的Gradle配置会出问题：

• 打开IDE的Preferences（Windows是Settings），找到Gradle选项，确认勾选了「Use Gradle wrapper」，而非手动指定本地安装的Gradle版本。
• 若之前选了本地Gradle，切换回wrapper模式，让项目使用自身配置的Gradle版本。

3. 解决Gradle包下载问题 #

异常里提到的gradle-4.0-all.zip下载失败是高频诱因：

• 检查网络是否能正常访问https://services.gradle.org/distributions/，如果网络受限，可以手动下载对应版本的Gradle zip包，放到本地Gradle缓存目录（默认路径是~/.gradle/wrapper/dists/gradle-4.0-all/[随机文件夹名]/）。
• 也可以在gradle-wrapper.properties里配置国内镜像地址替换默认下载链接，加快下载速度。

4. 清理缓存重置状态 #

缓存损坏也会导致这类奇怪的构建异常：

• 在Liferay IDE中执行File → Invalidate Caches...，选择清理缓存并重启IDE。
• 清理项目构建缓存：执行./gradlew clean build --no-build-cache，强制重新构建项目。

5. 检查Liferay插件版本 #

确保Liferay IDE的插件版本和你使用的Liferay 7版本完全匹配，比如Liferay 7.2需要对应版本的IDE插件，版本不兼容也会触发Gradle构建异常。

附你提到的异常信息：
org.gradle.tooling.BuildException: Could not run build action using Gradle distribution 'https://services.gradle.org/distributions/gradle-4.0-all.zip'.
at org.gradle.tooling.internal.consumer.ExceptionTransformer.transform(ExceptionTransformer.java:51)
at org.gradle.tooling.internal.consumer.ExceptionTransformer.transform(ExceptionTransformer.java:29)
at org.gradle.tooling.internal.consumer.ResultHandlerAdapter.onFailure(ResultHandlerAdapter.java:41)
at org.gradle....

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