java：springboot3集成swagger（springdoc-openapi-starter-webmvc-ui）

背景

网上集成 swagger 很多都是 Springfox 那个版本的，但是那个版本已经不更新了，springboot3 集成会报错 Typejavax.servlet.http.HttpServletRequest not present，我尝试了很多才知道现在用 Springdoc 了，今天我们来入门一下

名词解释

提起 api 文档，一般都能想起 swagger，但是除了 swagger，你可能还听说过OpenAPI、Springfox、Springdoc，这些和 swagger 又有什么关系呢？

OpenAPI

官网
是一个组织（OpenAPI Initiative），他们指定了一个如何描述HTTP API的规范（OpenAPI Specification）。既然是规范，那么谁想实现都可以，只要符合规范即可。

Swagger

官网
它是SmartBear这个公司的一个开源项目，里面提供了一系列工具，包括著名的 swagger-ui。swagger是早于OpenApi的，某一天swagger将自己的API设计贡献给了OpenApi，然后由其标准化了。

Springfox

官网
是Spring生态的一个开源库，是Swagger与OpenApi规范的具体实现。我们使用它就可以在spring中生成API文档。以前基本上是行业标准，目前最新版本可以支持 Swagger2, Swagger3 以及 OpenAPI3 三种格式。但是其从 2020年7月14号就不再更新了，不支持springboo