1. 概述

作为优秀的开发者，我们知道文档对于构建REST API至关重要，因为它帮助API的用户无缝工作。如今，大多数Java开发者都在使用Spring Boot。截至今日，有两种工具可以通过Springfox和SpringDoc简化Swagger API文档的生成和维护。

在本教程中，我们将讨论如何通过这些工具默认提供的Swagger-UI URL前缀进行修改。

2. 使用Springdoc更改Swagger UI URL前缀

首先，我们来查看如何使用OpenAPI 3.0设置REST API文档。

---

如何为Spring Boot应用中的OpenAPI配置JWT认证

如果你正在处理Spring Security（尤其是OAuth）实现，一定要看看《Learn Spring Security》课程：

> > LEARN SPRING SECURITY

1. 概述

OpenAPI 是一种语言无关且平台独立的规范，它标准化了REST API。OpenAPI 使用户能够轻松理解API而无需深入代码。Swagger-UI 基于这个OpenAPI规范生成一个用户界面，帮助可视化和测试REST API。

---

在SpringFox Swagger-UI中移除BasicErrorController

1. 概述

在本教程中，我们将学习多种方法来配置Spring Boot应用程序中的Swagger，以隐藏由_BasicErrorController_暴露的路径。

2. 目标项目

本文不会涵盖使用Spring Boot和Swagger-UI开始的基本配置。我们可以使用已经配置好的项目，或者按照“使用Spring REST API设置Swagger 2”的指南来创建基本配置。

3. 问题

如果我们的代码包含一个_BasicErrorController_，Swagger默认会将其所有端点也包含在生成的文档中。 我们需要提供自定义配置来移除不需要的控制器。