Micronaut OpenAPI无法合并依赖模块YAML：additional.files配置问题

你的配置存在几个关键问题，以下是修正方案和排查要点：

核心问题分析 #

1. 未启用OpenAPI插件：聚合模块必须配置Micronaut OpenAPI插件，否则不会触发合并逻辑——你只依赖了其他模块，但聚合模块本身没有执行OpenAPI生成/合并的构建步骤。
2. additional.files配置格式错误：直接指定目录不会被识别，需要用classpath*:前缀匹配所有依赖中的文件，或明确列出每个模块的OpenAPI文件路径。
3. 配置文件位置可能不正确：openapi.properties需放在聚合模块的src/main/resources目录下，才能被插件读取到。

具体修正步骤 #

1. 在聚合模块的pom.xml中添加OpenAPI插件 #

确保插件绑定到process-classes阶段，这是执行OpenAPI合并的核心步骤：

<plugin>
    <groupId>io.micronaut.openapi</groupId>
    <artifactId>micronaut-openapi-maven-plugin</artifactId>
    <version>${micronaut.openapi.version}</version> <!-- 与其他模块使用的版本一致 -->
    <executions>
        <execution>
            <id>generate-openapi</id>
            <phase>process-classes</phase>
            <goals>
                <goal>generate</goal>
            </goals>
        </execution>
    </executions>
    <configuration>
        <micronaut.runtime>netty</micronaut.runtime> <!-- 与你的运行环境匹配 -->
    </configuration>
</plugin>

2. 修正OpenAPI配置 #

在聚合模块的src/main/resources/openapi.properties中修改配置：

# 使用classpath*:扫描所有依赖中的匹配文件，支持通配符
micronaut.openapi.additional.files=classpath*:META-INF/swagger/openapi-*.yml
# 指定合并后的输出路径
micronaut.openapi.target.file=META-INF/swagger/openapi.yml

如果你的模块OpenAPI文件名不是openapi-*.yml格式，可直接列出所有文件路径（逗号分隔）：

micronaut.openapi.additional.files=classpath:META-INF/swagger/openapi-A.yml,classpath:META-INF/swagger/openapi-B.yml,classpath:META-INF/swagger/openapi-C.yml

3. 执行构建并验证 #

运行mvn clean package，然后检查聚合模块的target/classes/META-INF/swagger/目录，应该会生成合并后的openapi.yml文件。

额外排查要点 #

• 确认所有依赖模块的OpenAPI文件已正确打包到JAR中（你已经用jar tf验证过，这一步没问题）。
• 检查Micronaut OpenAPI版本兼容性，避免因版本差异导致配置不生效。
• 若使用application.yml或application.properties配置，需确保配置项层级正确：

  micronaut:
    openapi:
      additional-files: classpath*:META-INF/swagger/openapi-*.yml
      target-file: META-INF/swagger/openapi.yml
  

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