Swagger codegen Maven插件无法在SpringBoot中生成正确的dateFormat java.time.LocalDate

Swagger Codegen 是一个用于生成客户端库、服务器存根和文档的工具，它可以根据 OpenAPI（以前称为 Swagger）规范自动生成代码。Maven 插件使得在 Maven 构建过程中集成 Swagger Codegen 变得容易。

基础概念

• Swagger Codegen: 一个开源工具，用于从 OpenAPI 规范生成服务器存根、客户端库和 API 文档。
• Maven 插件: Maven 是一个项目管理和构建自动化工具，插件用于扩展 Maven 的功能。
• SpringBoot: 一个开源的 Java 框架，用于简化新 Spring 应用的初始搭建以及开发过程。

相关优势

• 自动化代码生成: 减少手动编写样板代码的工作量。
• 标准化: 生成的代码遵循 OpenAPI 规范，有助于保持 API 的一致性。
• 快速迭代: 在修改 API 规范后，可以快速重新生成代码。

类型

Swagger Codegen 支持多种编程语言和框架，包括但不限于 Java、JavaScript、Python、Ruby 等。

应用场景

适用于需要快速构建 RESTful API 服务，并希望自动生成客户端和服务器端代码的场景。

问题原因

Swagger Codegen Maven 插件在生成代码时可能无法正确处理 Java 8 的 java.time.LocalDate 类型，因为这是一个相对较新的日期时间 API，而 Swagger Codegen 可能默认使用的是旧的日期时间 API。

解决方法

1. 自定义模板: 使用 Swagger Codegen 的自定义模板功能来指定如何处理 LocalDate 类型。你可以下载 Swagger Codegen 的源码，修改模板文件，然后重新编译。
2. 使用注解处理器: 在项目中添加 jackson-datatype-jsr310 依赖，并配置 ObjectMapper 使用这个模块来序列化和反序列化 LocalDate。

<dependency>
    <groupId>com.fasterxml.jackson.datatype</groupId>
    <artifactId>jackson-datatype-jsr310</artifactId>
    <version>2.12.3</version> <!-- 使用最新版本 -->
</dependency>

然后在 Spring Boot 配置中配置 ObjectMapper：

@Bean
public ObjectMapper objectMapper() {
    ObjectMapper mapper = new ObjectMapper();
    mapper.registerModule(new JavaTimeModule());
    return mapper;
}

1. 更新 Swagger Codegen: 确保你使用的是最新版本的 Swagger Codegen，因为新版本可能已经修复了这个问题。

<plugin>
    <groupId>io.swagger.codegen.v3</groupId>
    <artifactId>swagger-codegen-maven-plugin</artifactId>
    <version>3.0.29</version> <!-- 使用最新版本 -->
    <executions>
        <execution>
            <goals>
                <goal>generate</goal>
            </goals>
            <configuration>
                <!-- 配置你的 OpenAPI 文件和其他选项 -->
            </configuration>
        </execution>
    </executions>
</plugin>

参考链接

• Swagger Codegen GitHub
• Spring Boot 官方文档
• Jackson 官方文档

通过上述方法，你应该能够解决 Swagger Codegen Maven 插件在 Spring Boot 中无法正确生成 LocalDate 类型的问题。