IntelliJ IDEA 项目启动时 java: java.lang.OutOfMemoryError: GC overhead limit exceeded 的解决方案

原创已于 2025-06-27 19:42:52 修改 · 1.7k 阅读

16 ·

CC 4.0 BY-SA版权

文章标签：

#java #intellij-idea #ide

于 2025-06-13 11:30:15 首次发布

Spring Boot 专栏收录该内容

14 篇文章

订阅专栏

错误详解：`GC overhead limit exceeded` 是什么意思？

这个错误是 JVM 为了防止程序完全卡死而提供的一种“快速失败”保护机制。它的触发条件是：

JVM 花费了超过 98% 的 CPU 时间在进行垃圾回收（Garbage Collection, GC）。
并且，在每次 GC 后，回收到的内存少于总堆内存的 2%。

用一个通俗的比喻来解释：
想象一下，你的编译器（JVM 进程）是一个办公室，内存（Heap）是办公室里的垃圾桶。

编译器在工作时（分析代码、生成字节码）会不断产生“垃圾”（临时对象）。
当垃圾桶快满时，清洁工（GC）就开始工作，试图清空垃圾桶。
GC overhead limit exceeded 的情况是：清洁工几乎把所有时间（98% 的 CPU 时间）都花在了清理垃圾上，但每次清理完，垃圾桶里还是几乎满的（只能腾出不到 2% 的空间）。

这时，JVM 就判断，再这样下去程序也做不了任何有意义的工作了，只会永远卡在“产生一点垃圾 -> 清理半天 -> 空间还是不够”的死循环里。于是，它果断抛出 GC overhead limit exceeded 错误，让进程终止。

结论：这个错误的根本原因仍然是分配给编译器进程的堆内存（Heap Size）不足以容纳你的大型项目在编译时所需的所有对象。

解决方案

解决方案的核心思想和上一个问题完全一样：为编译器进程提供更多的内存。但我们还可以有一个“治标”的备用方案。

方案一：根治问题——增加编译器堆内存（首选）

推荐的解决方案。

打开 IntelliJ IDEA 设置：
- Windows/Linux: File -> Settings
- macOS: IntelliJ IDEA -> Preferences
导航到编译器设置：
- Build, Execution, Deployment -> Compiler
找到并修改 Build process heap size (Mbytes) （中文界面：“用户本地构建进程堆大小 (Mbytes)”）：
- 这个值默认可能是 700 或 1024。
- 把它调大。建议直接设置为 2048 (即 2GB)。如果你的项目极其庞大或者电脑内存充足（16GB以上），设置为 4096 也可以。
应用并重启 IDEA：
- 点击 Apply 和 OK 保存。
- 强烈建议重启 IDEA (File -> Invalidate Caches / Restart... -> Just Restart) 来确保所有设置都已生效。

这通常能解决 99% 的此类问题。

方案二：治标方案——禁用 GC 开销限制（仅作为备用）

如果你已经给了很多内存（比如 4GB）但问题依旧，或者你想临时快速绕过这个问题，可以尝试禁用这个“GC 开销限制”的保护机制。

这相当于告诉清洁工：“别管效率了，就算每次只能扫出一点点垃圾，也给我继续扫，直到把垃圾桶彻底塞满为止！”

操作步骤：

同样在 Settings -> Build, Execution, Deployment -> Compiler -> Java Compiler 页面。
找到 Additional command line parameters （中文界面：“额外的命令行参数”）输入框。
在输入框中添加以下 JVM 参数：
```
-XX:-UseGCOverheadLimit
```
- -XX: 是标准 JVM 参数前缀。
- + 号表示启用某个特性，- 号表示禁用。
- -UseGCOverheadLimit 的意思就是“不使用 GC 开销限制”。
点击 Apply 和 OK 保存。

重要警告：
这只是一个“创可贴”方案。它并没有解决内存不足的根本问题。禁用这个限制后，可能会出现两种情况：

构建成功，但过程可能非常缓慢，因为 JVM 会花费极长的时间在低效的 GC 上。
最终还是会因为内存彻底耗尽而抛出更直接的 java.lang.OutOfMemoryError: Java heap space 错误。

因此，强烈建议优先使用方案一。只有在方案一无效或特殊情况下才考虑方案二。

针对 Maven / Gradle 的解决方案

如果你是在命令行或者配置 IDEA 使用 Gradle/Maven 进行构建，解决方案和上一个问题一样：

对于 Maven (pom.xml):
在 maven-compiler-plugin 中增加 <fork>true</fork> 和 <maxmem>2048m</maxmem>。

<plugin>
    <groupId>org.apache.maven.plugins</groupId>
    <artifactId>maven-compiler-plugin</artifactId>
    <configuration>
        <fork>true</fork>
        <maxmem>2048m</maxmem>
        <!-- 也可以在这里添加禁用GC限制的参数 -->
        <!-- <compilerArgs>
            <arg>-XX:-UseGCOverheadLimit</arg>
        </compilerArgs> -->
    </configuration>
</plugin>

对于 Gradle (gradle.properties):
在 gradle.properties 文件中增加或修改 org.gradle.jvmargs。

# 设置 Gradle Daemon 的 JVM 参数
# 同时增大堆内存并禁用GC开销限制
org.gradle.jvmargs=-Xmx2048m -XX:-UseGCOverheadLimit

总结与排查清单

首选方案：在 IDEA 设置中将 Build process heap size 增加到 2048 MB 或更高。
备用方案：在 IDEA 编译器的“额外命令行参数”中添加 -XX:-UseGCOverheadLimit。
检查构建工具：确认你的 IDEA 是使用自身的构建器还是 Gradle/Maven。如果是后者，请修改对应工具的配置文件。
清理缓存：执行 File -> Invalidate Caches / Restart... 有时能解决一些奇怪的 IDE 状态问题。

绝大多数情况下，只要正确执行了方案一，这个问题就能迎刃而解。