Swagger报错404

最新推荐文章于 2025-02-22 10:56:56 发布
最新推荐文章于 2025-02-22 10:56:56 发布
阅读量1.6w 收藏 7
点赞数 10
分类专栏： 学习
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.youkuaiyun.com/XXY411636013/article/details/111835277
版权
本文介绍了Swagger报错404的解决办法。作者按以往习惯用端口号加/swagger-ui.html路径访问Swagger出现404，后发现公司application.properties中有server.servlet.context-path=/shequapi配置，在访问路径上加/shequapi后访问成功。

摘要生成于 C知道 ，由 DeepSeek-R1 满血版支持， 前往体验 >

Swagger报错404解决办法

我在进行开启Swager的时候，习惯性的使用了以前端口号+/swagger-ui.html的这一条路径（http://localhost:8088/shequapi/swagger-ui.html）

查看端口号

端口号
查看Swagger的访问地址
查看Swagger的访问地址
按照之前的配置访问Swagger出现了404
使用端口号+/swagger-ui.html404报错了

但是公司的application.properties中发现他有这个配置server.servlet.context-path=/shequapi

查看application.properties发现了server.servlet.context-path=/shequapi的配置查看application.properties后发现server.servlet.context-path=/shequapi
所以在访问swagger的时候地址不对
因此在访问路径上加上了/shequapi后就显示成功了
（http://localhost:8088/shequapi/swagger-ui.html）
加上/shequapi了后可以正常访问Swagger

SpringBoot集成Swagger，报错404
赶路de人的博客
08-03 406
查看导入包的版本 <!--swagger--> <dependency> <groupId>io.springfox</groupId> <artifactId>springfox-swagger-ui</artifactId> <version>2.9.2</version> </dependency> <dependency> <g
Springboot集成Swagger报错：Error starting ApplicationContext. To display the conditions report re-run
肖肖的博客
10-19 1000
Springboot集成Swagger报错：Error starting ApplicationContext. To display the conditions report re-run your application with 'debug'..... 原因：maven依赖冲突，导致空指针异常 springboot版本太高了，导致swagger 异常，是springboot2.6.0版本以后引起的问题。 解决办法：将pom.xml的spring的版本降低到2.6.0以下，我用的2.1.1的
SpringBoot配置SwaggerUI访问404错误的解决方法
08-28
主要为大家详细介绍了SpringBoot配置SwaggerUI访问404错误的解决方法，具有一定的参考价值，感兴趣的小伙伴们可以参考一下
若依的swagger系统接口报错404
2403_83795864的博客
02-22 383
的依赖，它是一个用于集成 Swagger UI 的库，通常与 Spring Boot 项目一起使用。Swagger UI 是一个非常流行的 API 文档工具，它提供了一个用户友好的界面，可以查看和交互 RESTful API。
swagger文档访问地址404
htx845928748的博客
03-21 6163
解决swagger文档访问404：This application has no explicit mapping for /error, so you are seeing this as a fallback
Swagger接口报错404的其中一种情况
weixin_66562588的博客
06-07 1918
Controller类的 @RestController注解错误的使用了@Controller。将@Controller改为@RestController即可。导致返回的数据无法解析。一种粗心导致的可能就是。
解决Swagger3.0 访问swagger-ui.html出现404的问题
Jiao1225的博客
01-11 6847
朋友们能看到这篇文章，肯定是因为引入了Swagger3.0，导致访问之前的默认路径（swagger-ui.html） 出现了404，然后在各种博客上都没有找到解决方案，那咱就废话少说，，直接上货！
【踩坑记录：集成Swagger访问踩坑，多种404解决方法】
辣机小司的博客
01-17 1万+
正在学习搭建Springcloud项目，正好打算集成下Swagger，方便调用，不用开postman测试。按网上教程集成，搞了好久都没解决，开始以为是自己Springcloud项目依赖冲突，又建了个Springboot项目，依旧报错。疯了~
springBoot集成Swagger报错处理
King_3123的博客
07-07 1246
springBoot集成Swagger报错处理：“To display the conditions report re-run you application with 'debug' enabled.”
swagger报错java.lang.NumberFormatException: For input string: ““，解决方法
Vicky_2020的博客
09-14 4242
1、问题出现 偶然发现有一天，运行swagger会报java.lang.NumberFormatException: For input string: ""错误，出错的原因呢是因为 空字符串""无法转成Number。 2、分析 查阅大量资料发现是swagger版本的问题，我使用的是io.springfox:springfox-swagger2:2.9.2的版本，而该版本依赖了swagger-models的1.5.20版本（会导致报此错），深挖原因是1.5.20版本中的...
spring boot引入swagger报错处理
山野里的小菊花
06-26 1873
swagger 2.0版本和spring boot 3.x版本整合暂时是不行的，因为swagger的依赖底层用的是javax依赖包，而spring boot 3.x版本都是jakarta依赖包，一般是把spring boot2.5以下就可以了，但是想要2.5版本以上spring boot启动就会出报错。网上搜索了各种办法，包括clone别人的代码，感觉明明一模一样的，为什么别人就可以，自己的就不行。有位作者已经写的很清楚了，此处不再赘述，，没错，就是版本兼容问题，说干就干。
Swagger-ui.html页面出现404
weixin_72525373的博客
12-07 1487
因为 swagger-ui的引入比较简单，所以我先排查了一下依赖和配置，以及对应方法上的注解，都是正常的，并且同样的配置在mogu_web和mogu_admin项目是正常的，所以非常好奇问题出来哪里？
使用swagger，出现404错误
热门推荐
会飞的胖虎
07-04 1万+
今天使用swagger，配置什么都没有错，但是一直输入地址，会一直出现404错误，研究了半天才发现错误，有点坑。 pom如下： 项目的配置如下： 配置好以后一直无法登陆，是因为我在application.properties里设置了： server.servlet.context-path=/model 所以访问的时候是需要加 /model 很坑的一个bug ...
springboot配置swagger
kingmove的专栏
09-20 553
引入依赖 <dependency> <groupId>io.springfox</groupId> <artifactId>springfox-swagger2</artifactId> <version>2.9.2</version> </dependency> <d...
解决swagger文档接口404的问题
小杨互联网
06-08 5086
问题描述：swagger文件测试接口404排查和解决,遇到这样的问题如何解决和排查我们来看。接口测试：这个时候怎么解决呢？看日志1，分析问题的根源，如果是加了权限控制要放行swagger 地址，显示我们这个不是swagger没有放行，那就是鉴权出了问题。日志鉴权貌似也没有问题？那是什么原因导致的呢？ GET http://localhost:11031/{GET%20/ydpw/collection/list} 这个地址其实很多会说是多了一个空格其实不是的，正常会转码。那么到底是什么问题？原因是我们的
swagger 404问题+解决跨域问题
赵睿宇的博客
05-21 8845
缘起：今天做springboot集成swagger文档的时候。 出现了404问题。 什么集成swagger 这不有手就行？ 先加依赖： <!--swagger 依赖--> <dependency> <groupId>io.springfox</groupId> <artifactId>springfox-swagger2</artifactId>
swagger 404
weixin_43445815的博客
03-09 217
1.原理就不多说了。直接加入： @Configuration public class WebConfig extends WebMvcConfigurerAdapter { @Override public void addResourceHandlers(ResourceHandlerRegistry registry) { registry.addResourceHandler("swagger-ui.html") .addResourceLocations("clas
【bug日志】访问 swagger 或者 knife4j 产生404的问题
Hassanx的博客
10-09 2276
访问 swagger 或者 knife4j 产生404的问题，并且能够确保swagger的配置无误
swagger 404等问题总结
qq_35705176的博客
07-31 7025
swagger404问题
引入swagger报错
最新发布
03-15
### 解决 Spring Boot 项目中引入 Swagger 报错问题 在 Spring Boot 2.6.x 版本中，由于框架内部机制的变化以及依赖冲突等问题，在引入 `springfox-boot-starter` (即 Swagger 的实现) 后可能会遇到多种报错情况。以下是针对常见报错的解决方案。 #### 常见报错及其原因分析 1. **Failed to start bean ‘documentationPluginsBootstrapper’** 这种错误通常是因为 Spring Boot 2.6.x 默认禁用了 Bean 的循环引用检测功能[^1]。此外，Spring MVC 请求路径匹配器也发生了变化，从 `AntPathMatcher` 转变为 `PathPatternParser`，这可能导致某些旧版 Swagger 配置不兼容[^2]。 2. **NullPointerException 或其他运行时异常** 如果未正确配置 Swagger 或者存在版本不一致的情况，则可能引发 NullPointerException 等运行时异常[^3]。 --- #### 解决方案 ##### 方法一：调整 Maven 依赖并升级版本 确保使用的 `springfox-boot-starter` 是最新稳定版本，并与当前项目的 Spring Boot 版本保持兼容性。例如： ```xml <dependency> <groupId>io.springfox</groupId> <artifactId>springfox-boot-starter</artifactId> <version>3.0.0</version> </dependency> ``` 如果仍然存在问题，可以尝试切换到更高版本的 `springfox-boot-starter`，或者考虑使用 OpenAPI 工具替代 Swagger。 ##### 方法二：启用循环引用支持 对于因默认禁用循环引用而导致的问题，可以通过设置属性重新允许循环引用。修改 `application.properties` 文件如下： ```properties spring.main.allow-circular-references=true ``` 此操作可有效解决部分由循环引用引起的启动失败问题。 ##### 方法三：更改 Path Pattern Parser 行为 为了适配新的路径解析逻辑，可以在应用初始化阶段强制恢复至旧版行为 (`AntPathMatcher`)。通过自定义配置类完成这一目标： ```java import org.springframework.context.annotation.Configuration; import org.springframework.web.servlet.config.annotation.PathMatchConfigurer; import org.springframework.web.servlet.config.annotation.WebMvcConfigurer; @Configuration public class WebConfig implements WebMvcConfigurer { @Override public void configurePathMatch(PathMatchConfigurer configurer) { configurer.setUseRegisteredSuffixPatternMatch(true); configurer.useSuffixPatternMatch(false); // 关闭后缀模式匹配 configurer.setPathMatcher(new AntPathMatcher()); // 使用传统方式 } } ``` 上述代码片段将路径匹配器重设为传统的 `AntPathMatcher` 实现。 ##### 方法四：排查 NPE 及其他潜在问题 当发生 NullPointer Exception 时，需重点检查以下几个方面： - 是否遗漏了必要的注解（如 `@EnableSwagger2` 或其等价形式）； - API 文档扫描包范围是否覆盖实际接口所在的模块； - Docket 配置是否存在语法错误或参数缺失。 典型配置示例： ```java import springfox.documentation.builders.ApiInfoBuilder; import springfox.documentation.service.ApiInfo; import springfox.documentation.spi.DocumentationType; import springfox.documentation.spring.web.plugins.Docket; import org.springframework.context.annotation.Bean; import org.springframework.context.annotation.Configuration; @Configuration public class SwaggerConfiguration { @Bean public Docket api() { return new Docket(DocumentationType.OAS_30) .apiInfo(apiDetails()) .select() .build(); } private ApiInfo apiDetails() { return new ApiInfoBuilder().title("My Application API").description("Documentation for My App") .version("1.0").build(); } } ``` 以上代码展示了如何创建一个基本的 Docket 对象实例。 --- ### 总结 综合来看，Spring Boot 2.6.x 中集成 Swagger 所产生的各类问题主要源于新特性带来的向后兼容性挑战。通过对依赖管理、核心配置文件调整以及必要扩展手段的应用，能够显著降低此类风险的发生概率。
评论 3
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值