Liferay随机无法构建Gradle：com.liferay.workspace插件应用失败

问题现象 #

随机出现Gradle构建失败，报错如下：

> Failed to apply plugin 'com.liferay.workspace'.
> Could not create an instance of type com.liferay.gradle.plugins.workspace.WorkspaceExtension.
> Unable to get product info for :dxp-7.3-sp1

已尝试删除.gradle文件夹、重新导入项目、重装IntelliJ，问题仍未解决，且未修改过任何设置。

解决方案 #

1. 核对产品配置与依赖仓库

• 打开项目根目录的gradle.properties，确认liferay.workspace.product字段值为dxp-7.3-sp1，无拼写错误；
• 检查settings.gradle中是否正确配置Liferay官方仓库：

  repositories {
      maven {
          url "https://repository.liferay.com/nexus/content/groups/public/"
      }
  }
  

• 验证本地Maven仓库（默认~/.m2/repository）中是否存在com.liferay.portal/com.liferay.portal.impl/dxp-7.3-sp1相关依赖包，若缺失，在IntelliJ的Gradle面板点击刷新按钮，勾选Refresh external dependencies强制重新拉取。

2. 配置Gradle代理（网络受限场景）

若处于公司代理网络环境，在~/.gradle/gradle.properties或项目根目录的gradle.properties中添加代理配置：

systemProp.http.proxyHost=你的代理地址
systemProp.http.proxyPort=你的代理端口
systemProp.https.proxyHost=你的代理地址
systemProp.https.proxyPort=你的代理端口
# 跳过Liferay域名的代理（按需配置）
systemProp.http.nonProxyHosts=*.liferay.com|localhost
systemProp.https.nonProxyHosts=*.liferay.com|localhost

3. 锁定Liferay Gradle插件版本

在项目根目录的build.gradle中明确指定兼容dxp-7.3-sp1的Workspace插件版本，避免自动拉取不稳定版本：

buildscript {
    dependencies {
        classpath group: "com.liferay", name: "com.liferay.gradle.plugins.workspace", version: "3.4.40"
    }
}

注：dxp-7.3对应的插件版本通常在3.x系列，可根据实际兼容情况调整版本号。

4. 清理全量缓存

• 删除Liferay Workspace本地缓存目录：~/.liferay/workspace；
• 在IntelliJ中执行File -> Invalidate Caches...，选择Invalidate and Restart，彻底清除IDE缓存。

5. 排查网络稳定性

• 手动访问https://repository.liferay.com/nexus/content/groups/public/com/liferay/portal/com.liferay.portal.impl/dxp-7.3-sp1/，确认链接可正常访问，无超时或404；
• 尝试切换网络环境（如手机热点）重新构建，排除网络波动导致的依赖下载失败。

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