OpenAPI 3中如何将List初始化为ArrayList而非默认null？

可行，但你用的default: []是OpenAPI规范中API层面的默认值，不会映射到Java类字段的初始化逻辑上——生成器只会把它用于请求/响应的默认值填充，而非类实例化时的字段初始化。要实现List字段默认初始化为空ArrayList，有两种可靠方法：

方法1：启用生成器的集合初始化参数 #

Java版OpenAPI生成器提供了initializeCollections配置参数，开启后会自动将List、Set等集合类型字段初始化为空实现类实例。

Maven插件配置示例 #

在pom.xml的OpenAPI生成器插件中添加该参数：

<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/openapi.yaml</inputSpec>
                <generatorName>java</generatorName>
                <configOptions>
                    <initializeCollections>true</initializeCollections>
                    <!-- 其他配置如packageName等按需添加 -->
                </configOptions>
            </configuration>
        </execution>
    </executions>
</plugin>

命令行方式示例 #

openapi-generator generate -i your-openapi-spec.yaml -g java --additional-properties initializeCollections=true

启用后生成的代码会变成：

private List<Employee> employees = new ArrayList<>();

方法2：自定义代码模板 #

如果需要更精细的控制，可以修改生成器使用的Mustache模板：

1. 找到Java生成器的model.mustache模板文件（可从OpenAPI生成器源码中获取）
2. 定位到字段初始化的代码段，将原来的= null替换为= new ArrayList<>()（对应List类型）
3. 在生成代码时指定自定义模板路径：

   openapi-generator generate -i your-spec.yaml -g java -t /path/to/custom-templates
   

这种方式适合需要统一修改所有集合类型初始化逻辑的场景。

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