Springfox 3.0.0修改Swagger UI标题和描述无效求助
问题原因及解决办法
你遇到的核心问题是版本不兼容:你使用的是Swagger 3.0.0(实际为SpringDoc OpenAPI,是Swagger官方推荐的Spring整合方案),但代码里沿用了Swagger 2.x(Springfox)的API和注解,导致配置完全不生效。
具体错误点
@EnableSwagger2是Swagger 2.x专属注解,Swagger 3.0.0不需要该注解,保留它反而会干扰配置ApiInfoBuilder是Swagger 2.x的配置类,在3.0.0版本中已被全新的API替代
正确配置方式
直接使用Swagger 3.0.0对应的OpenAPI和Info类构建配置:
@Configuration public class SwaggerConfig { @Bean public OpenAPI customOpenAPI() { return new OpenAPI() .info(new Info() .title("Demo Test API") .description("Demo test API task") .license(new License().name("© 2021 by my"))); } }
额外注意事项
- 确保引入正确的Swagger 3.0.0依赖(以Maven为例):
<dependency> <groupId>org.springdoc</groupId> <artifactId>springdoc-openapi-starter-webmvc-ui</artifactId> <version>2.2.0</version> <!-- 版本需适配你的Spring Boot版本 --> </dependency>
- 彻底移除代码中无效的
@EnableSwagger2注解和ApiInfoBuilder相关代码 - Swagger 3.0.0的UI默认访问路径为:
http://localhost:8080/swagger-ui/index.html(和2.x的/swagger-ui.html不同)
内容的提问来源于stack exchange,提问作者Denis Voloshin
相关产品推荐
相关产品推荐

