OpenAPI Generator 6.6.0生成swagger.json时堆内存不足问题求助

问题本质 #

相关参考内容指出，OpenAPI Normalizer在处理大型或复杂的OpenAPI规范时，可能因递归处理逻辑、重复对象引用过多导致内存占用飙升，最终触发Java heap space溢出，且该问题在部分旧版本的OpenAPI Generator中表现更明显。

可行解决方案 #

1. 为任务单独分配更大堆内存 #

直接提升openApiGenerate任务的JVM内存配额，是最直接的临时缓解方案：

• 全局配置（gradle.properties）：

  org.gradle.jvmargs=-Xmx4g -XX:MaxMetaspaceSize=512m
  

  可根据实际情况调整-Xmx的值（比如-Xmx8g），Metaspace大小按需配置。
• 任务单独配置（build.gradle）：
  仅针对openApiGenerate任务增加内存，不影响其他Gradle任务：

  tasks.withType(org.openapitools.generator.gradle.plugin.tasks.GenerateTask) {
      jvmArgs '-Xmx4g', '-XX:MaxMetaspaceSize=512m'
  }
  

2. 精细化配置OpenAPI Normalizer #

避免启用全部Normalizer规则，仅保留业务必需的规则，减少不必要的内存消耗：

openApiGenerate {
    // 原有配置（如inputSpec、generatorName等）...
    normalizer = [
        'REF_AS_PARENT_IN_ALLOF': 'true',
        'REMOVE_UNUSED_COMPONENTS': 'true'
        // 仅保留你实际需要的Normalizer规则，注释掉非必需项
    ]
}

3. 升级OpenAPI Generator版本 #

相关修复记录显示，新版本的OpenAPI Generator已针对Normalizer的内存占用问题进行了优化（比如减少递归深度、优化对象复用逻辑）。建议升级到最新稳定版（v6.6.0及以上）：

plugins {
    id "org.openapi.generator" version "6.6.0"
}

4. 拆分大型OpenAPI规范（可选） #

如果你的OpenAPI文档规模极大，可将其拆分为多个独立的子规范文件，通过$ref关联引用，降低单次任务处理的数据量，缓解内存压力。

内容的提问来源于stack exchange，提问作者Rishy Rane