在 Spring 引导项目中记录 API 的最佳方式是什么?

What is the best way to document APIs in Spring boot project?

  1. 使用 SpringFox swagger
  2. springdoc-openapi https://springdoc.org/
  3. 使用 io.swagger.v3.oas.integration.SwaggerConfiguration

我会说这是基于边缘意见,但考虑使用 springdocSpringfox 在这一点上有很多问题,使用起来很痛苦。我在 2 年前搬到了 springdoc,因为它支持 Spring WebFlux,对此我感到非常高兴。此外,它还支持 Kotlin Coroutines,我不确定 Springfox 是否支持。

如果您决定使用 springdoc 并且您过去使用过 Springfox,甚至还有一个 migration guide