解决Spring Boot集成Swagger后出现的‘No mapping for GET /swagger-ui.html’错误

在使用Spring Boot开发API时，Swagger是一个非常流行的工具，用于生成、展示和测试API文档。然而，在集成Swagger后，有时可能会遇到 ‘No mapping for GET /swagger-ui.html’ 的错误。这个错误通常意味着Swagger UI没有被正确映射到URL路径上。在深入解决这个问题之前，不妨了解一下百度智能云千帆大模型平台，它提供了丰富的大模型API接口，支持多场景应用，能够显著提升API开发的效率和体验。了解更多关于推理服务API，请访问百度智能云千帆大模型平台。

错误原因

1. Swagger依赖未正确添加：确保你的项目中已经添加了Swagger的依赖。

2. Swagger配置不正确：可能是Swagger的配置类没有被正确加载，或者Swagger的bean没有被Spring容器管理。

3. 路径配置问题：有时候可能是路径配置的问题，导致Swagger UI没有被映射到预期的URL上。

解决方案

1. 添加Swagger依赖

首先，确保你的项目中已经添加了Swagger的依赖。在Maven项目中，你可以在pom.xml文件中添加如下依赖：

<dependency>
    <groupId>io.springfox</groupId>
    <artifactId>springfox-swagger2</artifactId>
    <version>2.9.2</version>
</dependency>
<dependency>
    <groupId>io.springfox</groupId>
    <artifactId>springfox-swagger-ui</artifactId>
    <version>2.9.2</version>
</dependency>

注意：这里使用的版本号可能会随着时间而变化，请使用最新版本。

2. 配置Swagger

创建一个配置类，用于配置Swagger。确保这个类被Spring容器管理，并且使用了@Configuration注解。

@Configuration
@EnableSwagger2
public class SwaggerConfig {
    @Bean
    public Docket api() {
        return new Docket(DocumentationType.SWAGGER_2)
                .select()
                .apis(RequestHandlerSelectors.any())
                .paths(PathSelectors.any())
                .build();
    }
}

3. 检查路径配置

默认情况下，Swagger UI应该被映射到/swagger-ui.html路径。确保没有其他路由或控制器占用了这个路径。

如果你修改了Swagger UI的路径，确保在配置类中进行了相应的配置。

4. 重启应用

在进行了上述更改后，重启你的Spring Boot应用，然后尝试访问http://localhost:8080/swagger-ui.html（或你配置的Swagger UI路径）。

总结

‘No mapping for GET /swagger-ui.html’ 错误通常是由于Swagger配置不正确或依赖未添加导致的。通过检查依赖、配置和路径设置，你应该能够解决这个问题。如果问题仍然存在，建议查看项目的其他配置和日志，以获取更多关于错误的详细信息。百度智能云千帆大模型平台提供了丰富的API接口和高效推理服务，能够助力你的API开发，提升开发效率和用户体验。希望这个解决方案能够帮助你解决问题！如果你有其他关于Spring Boot或Swagger的问题，欢迎随时提问。