IntelliJ IDEA 2025.3.4 启动失败问题解决记录
📌 问题概述
Windows 系统下 IntelliJ IDEA 2025.3.4 安装完成后启动失败,提示 Internal error 和 NullPointerException。
🔴 报错信息
Start Failed
Internal error
java.lang.Error: java.lang.NullPointerException
at com.jetbrains.JBR.<clinit>(JBR.java:70)
at com.intellij.platform.ide.bootstrap.StartupUtil$startApplication$4.invokeSuspend(startup.kt:179)
at kotlin.coroutines.jvm.internal.BaseContinuationImpl.resumeWith(ContinuationImpl.kt:34)
at kotlinx.coroutines.DispatchedTask.run(DispatchedTask.kt:100)
at kotlinx.coroutines.scheduling.CoroutineScheduler.runSafely(CoroutineScheduler.kt:610)
at kotlinx.coroutines.scheduling.CoroutineScheduler$Worker.runWorker(CoroutineScheduler.kt:775)
Caused by: java.lang.NullPointerException
at java.base/java.io.Reader.<init>(Reader.java:168)
at java.base/java.io.InputStreamReader.<init>(InputStreamReader.java:88)
at java.base/com.jetbrains.internal.ProxyRepository$Registry.readEntries(ProxyRepository.java:259)
at java.base/com.jetbrains.internal.ProxyRepository$Registry.<init>(ProxyRepository.java:241)
at java.base/com.jetbrains.internal.ProxyRepository.<init>(ProxyRepository.java:51)
at java.base/com.jetbrains.internal.JBRApi.<clinit>(JBRApi.java:83)
at com.jetbrains.exported.JBRApiSupport.bootstrap(JBRApiSupport.java:35)
at com.jetbrains.JBR.<clinit>(JBR.java:56)
JRE: 21.0.10+1-b1163.110 amd64 (JetBrains s.r.o.)
C:\Program Files\Java\jdk-17.0.5
🔍 环境信息
- 操作系统: Windows 10 (10.0)
- IDEA 版本: IntelliJ IDEA 2025.3.4 (build #IU-253.32098.37)
- JDK 版本: JDK 17.0.5 (同时安装了 JDK 21)
- IDEA 安装路径 :
D:\soft_dev\IntelliJ IDEA 2025.3.4\ - 配置目录 :
C:\Users\xx\AppData\Roaming\JetBrains\IntelliJIdea2025.3C:\Users\xx\AppData\Local\JetBrains\IntelliJIdea2025.3
📋 问题根因分析
根据日志分析,核心错误在于 ProxyRepository.readEntries() 方法读取配置文件时返回了 null,导致 NullPointerException。
错误栈:
java.lang.NullPointerException
at java.io.Reader.<init>(Reader.java:168)
at java.io.InputStreamReader.<init>(InputStreamReader.java:88)
at com.jetbrains.internal.ProxyRepository$Registry.readEntries(ProxyRepository.java:259)
at com.jetbrains.internal.ProxyRepository$Registry.<init>(ProxyRepository.java:241)
at com.jetbrains.internal.ProxyRepository.<init>(ProxyRepository.java:51)
at com.jetbrains.internal.JBRApi.<clinit>(JBRApi.java:83)
这个错误发生在 JBR (JetBrains Runtime) 的初始化阶段,说明 JBR 内置的代理仓库配置文件存在问题。
🔧 尝试过的解决方案
1️⃣ 修改 vmoptions 指定 JDK 17
在 idea64.exe.vmoptions 中添加:
properties
-Djava.home=C:\Program Files\Java\jdk-17.0.5
-Djetbrains.jdk.download.disabled=true
结果: ❌ 失败,仍然报错
2️⃣ 清理配置文件目录
尝试删除以下文件:
C:\Users\xx\AppData\Roaming\JetBrains\IntelliJIdea2025.3\migrate.configC:\Users\xx\AppData\Roaming\JetBrains\IntelliJIdea2025.3\disabled_plugins.txtC:\Users\xx\AppData\Roaming\JetBrains\IntelliJIdea2025.3\.lock
结果: ❌ 失败
3️⃣ 完全删除配置目录
bash
rmdir /s /q "C:\Users\xx\AppData\Roaming\JetBrains\IntelliJIdea2025.3"
rmdir /s /q "C:\Users\xx\AppData\Local\JetBrains\IntelliJIdea2025.3"
结果: ❌ 失败
4️⃣ 禁用代理仓库
在 idea64.exe.vmoptions 中添加:
properties
-Djetbrains.proxy.repository.disabled=true
结果: ❌ 失败
5️⃣ 禁用 JBR(最终解决方案)✅
操作: 将 IDEA 自带的 JBR 目录重命名
bash
mv "D:\soft_dev\IntelliJ IDEA 2025.3.4\jbr" "D:\soft_dev\IntelliJ IDEA 2025.3.4\jbr.disabled"
结果 : ✅ 成功启动!
✅ 最终解决方案
步骤 1: 关闭所有 IDEA 相关进程
bash
taskkill /f /im idea64.exe
taskkill /f /im java.exe
步骤 2: 禁用 JBR 目录
将 IDEA 安装目录下的 jbr 文件夹重命名为 jbr.disabled:
- 原路径:
D:\soft_dev\IntelliJ IDEA 2025.3.4\jbr - 新路径:
D:\soft_dev\IntelliJ IDEA 2025.3.4\jbr.disabled
步骤 3: 启动 IDEA
bash
"D:\soft_dev\IntelliJ IDEA 2025.3.4\bin\idea64.exe"
📝 完整配置修改记录
修改的文件: idea64.exe.vmoptions
路径: D:\soft_dev\IntelliJ IDEA 2025.3.4\bin\idea64.exe.vmoptions
properties
-Xms128m
-Xmx2048m
-XX:JbrShrinkingGcMaxHeapFreeRatio=40
-XX:ReservedCodeCacheSize=512m
-XX:+HeapDumpOnOutOfMemoryError
-XX:-OmitStackTraceInFastThrow
-XX:CICompilerCount=2
-XX:+IgnoreUnrecognizedVMOptions
-XX:+UnlockDiagnosticVMOptions
-XX:TieredOldPercentage=100000
-ea
-Dsun.io.useCanonCaches=false
-Dsun.java2d.metal=true
-Djbr.catch.SIGABRT=true
-Djdk.http.auth.tunneling.disabledSchemes=""
-Djdk.attach.allowAttachSelf=true
-Djdk.module.illegalAccess.silent=true
-Djdk.nio.maxCachedBufferSize=2097152
-Djava.util.zip.use.nio.for.zip.file.access=true
-Dkotlinx.coroutines.debug=off
-Djava.nio.file.spi.DefaultFileSystemProvider=com.intellij.platform.core.nio.fs.MultiRoutingFileSystemProvider
-Djava.home=C:\Program Files\Java\jdk-17.0.5
-Djetbrains.jdk.download.disabled=true
-Djetbrains.proxy.repository.disabled=true
-XX:+IgnoreUnrecognizedVMOptions
修改的文件: idea.properties
路径: D:\soft_dev\IntelliJ IDEA 2025.3.4\bin\idea.properties
在文件末尾添加:
properties
# Specify JDK location
idea.jdk=C\:\\Program Files\\Java\\jdk-17.0.5
💡 问题原理分析
JBR 是什么?
JBR (JetBrains Runtime) 是 IDEA 内置的 Java 运行时环境,基于 OpenJDK 开发,包含了 JetBrains 自己的优化和功能增强。
为什么会失败?
- IDEA 2025.3.4 内置的 JBR 存在 bug,导致
ProxyRepository初始化失败 ProxyRepository需要读取配置文件来加载内部组件,但配置文件缺失或损坏- 这是一个 JBR 自身的 bug,与外部 JDK 配置无关
为什么禁用 JBR 后可以正常工作?
禁用 JBR 后,IDEA 会使用外部配置的 JDK 17 作为运行环境,绕过了有问题的 JBR 组件,从而成功启动。
📌 注意事项
-
数据安全: 禁用 JBR 后,IDEA 会使用外部 JDK,确保外部 JDK 版本兼容(建议 JDK 17 或 JDK 21 最新版本)
-
功能影响: 部分 JBR 特有的功能(如 HiDPI 优化、JetBrains 特定 UI 组件)可能无法使用,但核心功能不受影响
-
后续更新: 建议关注 JetBrains 官方更新,后续版本可能修复此问题,届时可以恢复 JBR
-
日志位置: 如遇其他问题,可查看日志文件:
C:\Users\yren\AppData\Local\JetBrains\IntelliJIdea2025.3\log\idea.log
🔗 参考资料
日期 : 2026-03-20
环境: Windows 10 + IntelliJ IDEA 2025.3.4 + JDK 17