IntelliJ IDEA 构建进程内存不足导致 OOM 错误排查与设置

IntelliJ IDEA 构建进程内存不足排查

在 Java 开发中，偶尔会遇到 java: OutOfMemoryError: insufficient memory 报错。这通常不是运行时堆内存不够，而是 IDE 的构建进程（Build Process）分配到的内存超出了限制。

上图红框里的'1024'，指的是共享构建进程堆大小（单位 MB）。这个参数专门给 IDEA 的编译任务用。调大它能缓解复杂项目的编译崩溃，但设得太高会占用过多物理内存，甚至触发虚拟内存交换，反而拖慢速度。得根据机器配置和项目体量来平衡。

具体怎么定？

小型项目一般几十到几百个文件，依赖也少，256MB 到 512MB 足够。中型 Web 应用涉及多模块交互，建议 512MB 到 1024MB。如果是微服务架构这种大型分布式系统，编译任务重，测试代码多，那就得开到 1024MB 甚至 2048MB 以上。

调整位置通常在 Settings -> Build, Execution, Deployment -> Compiler -> Shared build process heap size。改完记得重启 IDEA 生效。