同事swagger遇到的刁钻问题----- HTML文档可以查阅，doc文档显示空白

最新推荐文章于 2024-05-31 21:25:48 发布
最新推荐文章于 2024-05-31 21:25:48 发布
阅读量748 收藏
点赞数
分类专栏： 问题记录 文章标签： spring boot
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.csdn.net/weixin_45609613/article/details/130765745
版权

今天遇到同事的一个swagger刁钻问题，在swagger-ui里面可以直接访问
在这里插入图片描述
然而在doc.html文档里点进具体方法，确显示如下：
![在这里插入图片描述](https://img-blog.csdnimg.cn/6f950d7ca50f4a0ab7c8c0709781d27e.png

首先排除swagger集成错误问题，毕竟其他接口都是正常显示，初步判断代码问题
查看代码最后发现是名称问题
在这里插入图片描述

还是傻了·······，其实看URL就可以发现是路径问题， 设备借出/归还中的 “”/“” 在swagger-ui中是被转译成了 设备借出**%2F**归还

海边看浪丶
关注
  • 0
    点赞
  • 踩
  • 0
    收藏
    觉得还不错? 一键收藏
  • 0
    评论
专栏目录
使用spring boot + swagger2markup + springFox + asciidoctor自动生成HTML、PDF接口文档，并解决中文显示为空白问题
逆天子陆离的博客
07-11 2848
做后端开发，自然离不开接口文档，接口文档不仅方便后端开发人员之间查看，更是前端人员必要的文档，也有可能提供给第三方来调用我们的接口。但是，写接口文档太费时间，而且如果没有确定好格式，每个人写的接口文档可能各不相同，看起来就会很混乱。 好在swagger出现了，如果你的spring boot项目集成了swagger，而且接口和入参出参实体类加上了swagger相关的注解(参考最终demo中的con...
swagger使用文档
10-10
关于swagger使用的一些步骤及用法
Swagger报错，访问测试接口页面doc.html报错：java.lang.NumberFormatException: For input string: ““，swagger-ui插件的使用
zhangfuping123456789的博客
12-14 703
swagger、swagger-ui
接入knife4j-openapi3访问/doc.html页面空白问题
最新发布
coisini.cn记录
05-31 499
knife4j-openapi3访问/doc.html页面空白问题
swagger页面 doc.html出不来，swagger-ui/index.html能出来
songqiang2011的博客
05-29 2811
- 升级‘swagger-models’jar包版本：为了解决swagger启动时 默认值转换报错 NumberFormatException: For input string: "" -->swagger页面 doc.html出不来，swagger-ui/index.html能出来。前前后后折腾了很久，jar包冲突，jar包版本，添加路径啥的都弄了，就是出不来。需要升级‘swagger-models’jar包版本。定位到doc.html。
【转】集成 swagger-bootstrap-ui后访问 doc.html页面404
热门推荐
魂-淡
01-09 2万+
SpringBoot访问doc.html页面404 默认情况下并不需要添加此配置即可访问 很多朋友在使用SpringBoot集成swagger-bootstrap-ui后，都无法访问doc.html界面，此时，你可能需要实现SpringBoot的WebMvcConfigurer接口，添加相关的ResourceHandler,代码如下： @SpringBootApplication public c...
Springboot配置Swagger展示API文档并进行接口测试(doc.html、swagger-ui.html)
LSW1737554365的博客
06-30 6213
Springboot简单快速配置Swagger展示API文档并进行接口测试(doc.html、swagger-ui.html)
swagger-annotations-1.5.6-API文档-中英对照版.zip
04-07
赠送原API文档：swagger-annotations-1.5.6-javadoc.jar 赠送源代码：swagger-annotations-1.5.6-sources.jar 包含翻译后的API文档：swagger-annotations-1.5.6-javadoc-API文档-中文(简体)-英语-对照版.zip 对应...
swagger-models-1.5.6-API文档-中英对照版.zip
04-07
赠送原API文档：swagger-models-1.5.6-javadoc.jar 赠送源代码：swagger-models-1.5.6-sources.jar 包含翻译后的API文档：swagger-models-1.5.6-javadoc-API文档-中文(简体)-英语-对照版.zip 对应Maven信息：...
springfox-swagger2-2.4.0-API文档-中英对照版.zip
04-07
赠送原API文档：springfox-swagger2-2.4.0-javadoc.jar 赠送源代码：springfox-swagger2-2.4.0-sources.jar 包含翻译后的API文档：springfox-swagger2-2.4.0-javadoc-API文档-中文(简体)-英语-对照版.zip 对应...
springfox-swagger-common-2.4.0-API文档-中英对照版.zip
04-07
赠送原API文档：springfox-swagger-common-2.4.0-javadoc.jar 赠送源代码：springfox-swagger-common-2.4.0-sources.jar 包含翻译后的API文档：springfox-swagger-common-2.4.0-javadoc-API文档-中文(简体)-英语-...
swagger生成html离线接口文档
04-15
swagger生成html离线接口文档swagger生成html离线接口文档
swagger-annotations-1.6.2-API文档-中文版.zip
06-04
赠送原API文档：swagger-annotations-1.6.2-javadoc.jar； 赠送源代码：swagger-annotations-1.6.2-sources.jar； 赠送Maven依赖信息文件：swagger-annotations-1.6.2.pom； 包含翻译后的API文档：swagger-...
swagger doc.html,yaml - Converting Swagger specification JSON to HTML documentation - Stack Overflow
weixin_42494891的博客
06-27 236
For some REST APIs written in PHP, I was asked to create Swagger documentation, and since I was not aware of any easy way of adding annotations to those existing APIs and create such a documentation, ...
swagger接口文档出现的空文档问题
qq_42721085的博客
05-18 2707
记一次使用swagger接口文档出现的空文档问题 问题描述： 上面显示的一些空文档 下面的才是真正的正确文档： 最终尝试发现问题： 原因：**@Api(value = "ExamPaperController")** 和方法上面的@ApiOperation(value = "ExamPaper条件分页查询",notes = "分页条件查询ExamPaper方法详情" ,**tags = {"ExamPaperController"}**)value 与 tags 对应不一致问题 解决方案： 方案1.将@
springboot + swgger遇到的坑 - 通过网关聚合文档时请求地址‘/v2/api-docs‘发生空指针异常，但单独打开服务的接口确正常
u010713726的博客
03-08 351
而通过网关聚合调用接口“/v2/api-docs”时报异常，最终通过断点跟踪发现所写的接口里参数设置不规范导致，如请求地址中的/path/{id} => func(@PathVariable("id") String dataId)这种写法，以及 ApiImplicitParam(name="name") 对应方法参数里的username等不统一的写法很可能会导致异常。同样api注解里的参数说明包含特殊字符时也可能导致异常，如斜杠(/)。多检查，除了配置问题外，一般是接口参数写法问题导致！
swagger接口文档请求/localhost:8080/doc.html被过滤器拦截
weixin_44463218的博客
05-17 2584
swagger接口文档请求/localhost:8080/doc.html被过滤器拦截
SpringBoot配置knife4j版的Swagger打开doc.html页面404
青汁的博客
06-17 5669
项目原因： 　　最近搭建一个新的SpringBoot项目，需要配置Swagger，从其他项目里拷过来knife4j版的Swagger配置文件，结果打开doc.html显示404，如下图：
renren-security项目开发文档4.0：从入门到实战
- 4.2Swagger使用：介绍如何利用Swagger来创建API文档和进行接口测试。 - 4.3Mybatis-plus使用：讲述Mybatis-Plus的集成，以及它的CRUD操作和高级特性。 5. **项目实战** - 5.1需求说明：列出一个具体的开发实例...
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

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

抵扣说明：

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

余额充值