Sobes.tech
Senior

Were there any issues with OpenAPI when transitioning from Spring Boot 2 to 3?

sobes.tech AI

Answer from AI

When migrating from Spring Boot 2 to 3, there can indeed be issues with OpenAPI, especially if using the springdoc-openapi library. The main challenges are related to dependency updates and changes in the Spring Framework 6 API, on which Spring Boot 3 is based. For example, some annotations and classes may have been moved or modified, requiring updates to the OpenAPI configuration.

Common issues include:

  • Incompatibility of springdoc-openapi versions with Spring Boot 3 (using versions that support Spring Boot 3 is necessary).
  • Changes in annotation handling, such as @Schema, @Operation.
  • Updating configuration classes and properties.

It is recommended to carefully read the release notes of springdoc-openapi and Spring Boot, and to test documentation generation after migration.