You need to enable JavaScript to run this app.
优惠活动
大模型
产品
解决方案
定价
更多

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")));
    }
}

额外注意事项

  1. 确保引入正确的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>
  1. 彻底移除代码中无效的@EnableSwagger2注解和ApiInfoBuilder相关代码
  2. Swagger 3.0.0的UI默认访问路径为:http://localhost:8080/swagger-ui/index.html(和2.x的/swagger-ui.html不同)

内容的提问来源于stack exchange,提问作者Denis Voloshin

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.07.13 04:21:17