PyCharm 启动报错 Archived non-system classes are disabled 解决方案

该错误信息表明 Java 虚拟机（JVM）在启动时禁用了 CDS 存档中非系统类的加载，通常与类加载器设置有关。下面将解释该错误的原因及解决方法。

错误原因

1. 核心冲突：当你通过 -Djava.system.class.loader 指定了自定义的系统类加载器（如 com.intellij.util.lang.PathClassLoader）时，JVM 会禁用对 CDS（Class Data Sharing）存档中非系统类的加载。CDS 是一种优化机制，旨在通过共享已加载的类元数据来加速 JVM 启动。指定自定义类加载器破坏了 CDS 依赖的固定类加载结构，因此 JVM 会禁用此功能以避免潜在的不一致性问题。
2. 启动失败：警告之后还跟随了 FATAL ERROR in native method: processing of -javaagent failed, processJavaStart failed。这表明处理 Java 代理（-javaagent）时发生了致命错误。该代理可能是 IDE 自身功能所需，也可能是手动添加的第三方代理。由于自定义类加载器的设置或与之相关的兼容性问题，JVM 无法成功初始化这个代理，导致整个启动过程失败。
3. 常见诱因：
   • IDE 配置问题：IntelliJ IDEA 或 PyCharm 等 IDE 在启动脚本中通常会预设一些 JVM 参数，包括指定类加载器或添加 Java 代理。安装升级、配置损坏或不兼容的版本可能导致这些参数出错。
   • 环境变量冲突：系统环境变量 JAVA_TOOL_OPTIONS 或 _JAVA_OPTIONS 中可能设置了 -javaagent 或 -Djava.system.class.loader 参数，这些设置会影响所有 Java 应用程序，可能与 IDE 的预期配置冲突。
   • JDK 版本兼容性：你使用的 JDK 版本与 IDE 或其代理库可能不兼容。例如，较新的 JDK 版本可能弃用了某些特性或更改了内部机制。
   • 代理文件问题：-javaagent 指定的代理 Jar 包路径错误、文件损坏或版本不兼容。

解决方法

请尝试按以下顺序操作，通常能解决该问题。

1. 检查并清理环境变量
   • 临时移除系统环境变量 JAVA_TOOL_OPTIONS 和 _JAVA_OPTIONS 中可能包含的 -javaagent 或 -Djava.system.class.loader 参数。
   • 完成后，再次尝试启动你的 Java 应用程序或 IDE。
2. 检查并修复 IDE 配置
   如果你是在启动 IntelliJ IDEA、PyCharm 等 IDE 时遇到此错误：
   • 检查启动脚本/配置文件：查看 IDE 安装目录下 bin 文件夹中的启动脚本（如 idea.bat, idea.sh, pycharm.sh) 或配置文件（如 idea.properties），确认是否存在 -Djava.system.class.loader=... 或 -javaagent:... 的设置。若有，请检查其路径是否正确，尤其是路径中包含空格或特殊字符时是否被正确引用。
   • 重置 IDE 配置：如果问题是在升级 IDE 后出现的，很可能是旧配置与新版本不兼容。可以尝试重命名或删除 IDE 的配置目录（例如，对于 IntelliJ IDEA，通常在用户目录下的 ~/.IntelliJIdea2025.1 或 ~/AppData/Roaming/JetBrains/IntelliJIdea2025.1），然后重启 IDE 让其重新生成默认配置（注意：此操作会丢失你的个人设置）。
   • 检查使用的 JDK：确保 IDE 本身使用的是其自带的 JetBrains Runtime (JBR) 或一个兼容的 JDK 版本。你可以在 IDE 的设置中查看或更改所使用的 JDK。
3. 验证 Java 代理 如果你手动为应用程序添加了 参数（例如用于性能监测、代码覆盖率等）：