如何用OpenAPI Generator为Java生成指定接口及所需关联组件？

核心方案：用OpenAPI Generator的精准选择参数 #

OpenAPI Generator（官方工具）支持直接指定要生成的接口，并且会自动递归分析该接口依赖的所有模型，只生成必要的代码，完全不需要手动编辑原始OpenAPI文件。

关键参数说明

• --apis：指定目标接口的路径、标签或正则表达式，精准锁定要生成的接口。
• 无需手动指定--models：当你用--apis指定接口后，工具会自动扫描该接口的请求、响应定义，找出所有关联的Schema（模型），只生成这些模型，不会包含无关组件。

示例实现

Maven插件方式（适合项目集成）

在pom.xml中配置插件，指定目标接口：

<plugin>
    <groupId>org.openapitools</groupId>
    <artifactId>openapi-generator-maven-plugin</artifactId>
    <version>6.6.0</version>
    <executions>
        <execution>
            <goals>
                <goal>generate</goal>
            </goals>
            <configuration>
                <inputSpec>${project.basedir}/src/main/resources/large-openapi.yaml</inputSpec>
                <generatorName>java</generatorName>
                <apiPackage>com.your.app.api</apiPackage>
                <modelPackage>com.your.app.model</modelPackage>
                <!-- 替换为你的目标接口路径或标签 -->
                <apis>
                    <api>/orders/{orderId}</api>
                </apis>
                <configOptions>
                    <dateLibrary>java8</dateLibrary>
                    <serializationLibrary>jackson</serializationLibrary>
                </configOptions>
            </configuration>
        </execution>
    </executions>
</plugin>

CLI命令方式（适合快速测试）

直接用命令行生成：

openapi-generator generate \
  -i large-openapi.yaml \
  -g java \
  --apis "/orders/{orderId}" \
  --api-package com.your.app.api \
  --model-package com.your.app.model \
  --additional-properties dateLibrary=java8,serializationLibrary=jackson

验证生成结果

生成后检查输出目录：

• api包下只有目标接口的Client和相关接口类
• model包下仅包含该接口请求体、响应体直接或间接引用的模型类，无关的Schema不会被生成

备选方案：用OpenAPI Filter工具预处理（复杂场景） #

如果原始OpenAPI文件有特殊结构，也可以先用工具过滤出目标接口及其依赖模型，再生成客户端。比如用openapi-filter类工具，但这种方式不如直接用Generator的--apis参数高效，推荐优先用前者。

内容的提问来源于stack exchange，提问作者Marat Tim