Swagger Maven Plugin多执行单元配置不独立问题咨询

这个问题并非swagger-maven-plugin不支持多执行单元独立生成文档，而是插件默认复用上下文导致的扫描结果污染，以下是具体解决方法：

1. 为每个执行单元配置独立contextId #

Maven插件默认会共享上下文环境，指定不同的contextId可以让每个执行单元拥有独立的运行上下文，避免数据交叉覆盖。示例配置如下：

<plugin>
    <groupId>io.swagger.core.v3</groupId>
    <artifactId>swagger-maven-plugin</artifactId>
    <version>最新版本号</version>
    <executions>
        <!-- 第一个API执行单元 -->
        <execution>
            <id>generate-first-api</id>
            <phase>compile</phase>
            <goals>
                <goal>resolve</goal>
            </goals>
            <configuration>
                <contextId>first-api-context</contextId>
                <resourcePackages>
                    <package>com.yourcompany.api.first</package>
                </resourcePackages>
                <outputFileName>firstAPI</outputFileName>
                <outputPath>${project.build.directory}/swagger</outputPath>
                <configLocation>classpath:swagger-first-config.yaml</configLocation>
            </configuration>
        </execution>
        <!-- 第二个API执行单元 -->
        <execution>
            <id>generate-second-api</id>
            <phase>compile</phase>
            <goals>
                <goal>resolve</goal>
            </goals>
            <configuration>
                <contextId>second-api-context</contextId>
                <resourcePackages>
                    <package>com.yourcompany.api.second</package>
                </resourcePackages>
                <outputFileName>secondAPI</outputFileName>
                <outputPath>${project.build.directory}/swagger</outputPath>
                <configLocation>classpath:swagger-second-config.yaml</configLocation>
            </configuration>
        </execution>
    </executions>
</plugin>

2. 禁用插件缓存 #

部分版本的插件会缓存API扫描结果，强制关闭缓存可以确保每个执行单元重新扫描资源：
在每个执行单元的<configuration>中添加：

<cache>false</cache>

3. 确保配置完全隔离 #

• 确认每个执行单元的resourcePackages指向完全不同的API包路径
• 输出文件名、配置文件路径完全独立，避免复用同一配置
• 若自定义了info、servers等Swagger全局配置，确保每个执行单元的配置文件中明确覆盖这些参数，不依赖默认继承

4. 避免Maven并行构建冲突 #

如果使用了Maven并行构建参数（如-T），暂时关闭并行执行，或者将两个执行单元绑定到不同的构建阶段（比如第一个绑定compile，第二个绑定process-classes），防止并行执行时的资源竞争。

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