升级 IntelliJ IDEA 2026.1 后 Gradle 无法同步或构建怎么办？

先区分 IDE 同步故障和 Gradle 构建故障

仅凭这段日志无法确定唯一的修复方法。先在终端用项目的 Gradle Wrapper 执行构建，判断问题是否只发生在 IntelliJ IDEA 中，再检查 IDE 的 Gradle 集成、插件和运行环境。

异常显示，IDE 的 Gradle 工具代码尝试将 InternalIdeaModule 转换为 ProjectModel，但转换失败。排查时可以关注模型类型或集成兼容性，但不能据此认定依赖缓存已经损坏，也不能确认 IntelliJ IDEA 2026.1 存在某个已知缺陷。

1. 在终端使用项目的 Gradle Wrapper

在包含 gradlew 的项目根目录执行：

./gradlew --version
./gradlew build --stacktrace

Windows 使用：

.\gradlew.bat --version
.\gradlew.bat build --stacktrace

如果项目没有 build 任务，请改用项目实际使用的构建任务。使用 Wrapper 可以基于项目指定的 Gradle 版本进行排查，避免混入系统安装的其他版本。

根据结果继续定位：

• 终端构建成功，IDE 同步失败：优先检查 IDE 中的 Gradle 配置、Gradle JVM 和已安装插件。
• 终端也构建失败：查看完整堆栈，确认是否出现相同异常，还是其他脚本、插件、JDK 或依赖解析错误。

终端构建成功不代表 IDE 导入模型也会正常，IDE 同步还会执行自己的模型获取流程。

2. 核对 IDE 与终端使用的环境

检查项目的 gradle/wrapper/gradle-wrapper.properties，记录 distributionUrl 指定的 Gradle 版本。在 IDE 的 Gradle 设置中确认使用项目的 Wrapper，并核对 Gradle JVM 与终端构建所用的 JDK。

不要只看项目的语言级别。运行 Gradle 的 JDK 与编译代码使用的 Java toolchain 是两项不同的配置，需要分别核对。

由于缺少 Gradle 版本、JDK 版本和完整堆栈，目前无法给出可靠的版本组合，也没有依据直接升级或降级 Gradle。

3. 检查插件并重启 Gradle daemon

如果故障只出现在 IDE 中，可以先临时禁用自行安装的、与 Gradle 导入或构建相关的第三方插件，重启 IDE 后重新同步。保留项目同步必需的内置 Gradle 支持；如果问题消失，再逐个恢复插件，确认触发条件。

日志中的两个 PluginClassLoader 标识说明相关类型来自不同的插件类加载器，但不能仅凭这一点认定某个插件重复安装或存在冲突。

也可以关闭 IDE，再从项目目录执行：

./gradlew --stop

随后重新打开 IDE 并同步。该命令会停止相应 Gradle 版本的 daemon，但不保证停止机器上所有版本的 Gradle 进程。

不必直接终止所有 Java 进程，这样会影响其他 Java 应用。只有进程无法正常退出时，再定位并处理具体的 Gradle 进程。

4. 有依赖解析证据时再刷新缓存

IDE 显示的“依赖缓存可能损坏”只是排查提示，并不证明缓存已经损坏。

如果完整日志中还出现依赖下载失败、缓存文件无法读取等错误，可以尝试：

./gradlew build --refresh-dependencies --stacktrace

运行该命令需要能够访问依赖仓库，也不能保证解决 IDE 模型类型转换异常。仅凭当前报错，不建议直接删除整个 Gradle 缓存目录。

5. 升级后仍无法恢复时如何处理

如果同一项目在升级前可以正常同步，可以用升级前可用的 IDE 版本做对照，并尽量保持项目、Wrapper、JDK 和插件条件一致。对照结果有助于缩小排查范围，但单凭它不能确定根因。

后续定位需要保留以下信息：

• IntelliJ IDEA 的完整版本和构建号。
• Wrapper 指定的 Gradle 版本、Gradle JVM 和操作系统。
• 终端构建结果，以及 IDE 同步的完整异常堆栈。
• 已安装的相关第三方插件及版本。

这些信息有助于判断问题出在 IDE 导入流程、插件兼容性还是项目自身的构建配置。现有材料不足以保证某个补丁版本或单一操作能够修复问题。

备注：内容仅供参考。