SpringBoot3 集成SpringDoc/Swagger、Knife4j

---

前言

在软件开发过程中，API文档的编写和管理是非常重要的一环。它不仅可以帮助开发人员更好地理解和使用接口，还可以提供给其他团队成员、合作伙伴或客户查阅和理解项目的接口设计。而在Spring Boot项目中，集成Swagger是一种常见的方式来生成和管理API文档。

然而，随着时间的推移，我们发现SpringFox这个常用的Swagger集成库已经停止更新，并且对于最新的Spring Boot版本不兼容。为了解决这个问题，我们决定转而使用SpringDoc，一个更新更快且支持OpenAPI 3和Spring Boot 3的开源库。

本文将介绍如何使用SpringDoc替代SpringFox，并提供了一些注意事项和示例代码。希望通过本文的介绍，能够帮助大家更好地理解和使用SpringDoc，提升API文档的编写和管理效率。让我们一起开始吧！

---

使用SpringDoc替代SpringFox

在开发过程中，我们经常需要使用Swagger来生成API文档。而在Spring Boot项目中，最常用的Swagger集成库就是SpringFox。然而，SpringFox已经三年没有更新了，并且对于Spring Boot 3.0不兼容。因此，我们使用更新更快且支持OpenAPI 3和Spring Boot 3的SpringDoc。

1. SpringDoc简介

SpringDoc是一个用于生成API文档的开源库，它提供了一套注解来描述API的信息