OpenAPI Generator 4.3.1：数组文件Multipart生成Mono而非Flux问题

针对你遇到的OpenAPI Generator生成Multipart数组文件接口时，未正确使用Flux而是生成Mono的问题，可从以下几个方向排查：

1. OpenAPI YAML定义是否规范 #

首先确认数组类型的Multipart参数是否符合OpenAPI规范，这是生成器识别数组类型的基础：

• 若使用OpenAPI 3.x，需在requestBody的multipart/form-data schema中，明确标记参数为数组类型：

requestBody:
  content:
    multipart/form-data:
      schema:
        type: object
        properties:
          files:  # 数组参数名
            type: array
            items:
              type: string
              format: binary

• 避免使用旧版OpenAPI 2.x的collectionFormat等已废弃关键字，确保type: array和items定义清晰。

2. OpenAPI Generator版本bug #

你使用的4.3.1版本是2020年的旧版本，存在不少已知的Reactor相关生成bug，其中就包括Multipart数组参数的isArray变量未正确传递到模板的问题。后续的5.x及以上版本已修复这类问题，建议直接升级到最新稳定版（如7.x系列）后重试。

3. Maven插件配置是否正确 #

检查Maven插件的configOptions是否开启了Reactive模式：

<plugin>
  <groupId>org.openapitools</groupId>
  <artifactId>openapi-generator-maven-plugin</artifactId>
  <version>最新稳定版</version>
  <configuration>
    <generatorName>spring</generatorName>
    <configOptions>
      <reactive>true</reactive>
      <useReactiveFeignClient>true</useReactiveFeignClient>
    </configOptions>
  </configuration>
</plugin>

若未明确设置reactive: true，生成器可能不会正确启用Reactor相关的模板逻辑。

4. 模板变量调试验证 #

可以临时修改formParams.mustache模板，添加调试输出确认isArray变量的取值：
在模板中插入{{debug}}标签，生成代码时会输出所有模板变量的详细信息，查看数组参数的isArray是否为true。如果该值为false，说明生成器在解析YAML时未识别出数组类型，需回到第一步检查YAML定义。

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