方法:解压翻译后的API文档,用浏览器打开“index.html”文件,即可纵览文档内容。
人性化翻译,文档中的代码和结构保持不变,注释和说明精准翻译,请放心
赠送jar包:
swagger
-annotations-2.1.2.jar;
赠送原API文档:
swagger
-annotations-2.1.2-javadoc.jar;
赠送源代码:
swagger
-annotations-2.1.2-sources.jar;
赠送Maven依赖信息文件:
swagger
-annotations-2.1.2.pom;
包含翻译后的API文档:
swagger
-annotations-2.1.2-javadoc-API文档-中文(简体)版.zip;
Maven坐标:io.
swagger
.core.v3:
swagger
-annotations:2.1.2;
标签:core、annotations、v3、
swagger
、jar包、java、中文文档;
使用
方法:解压翻译后的API文档,用浏览器打开“index.html”文件,即可纵览文档内容。
人性化翻译,文档中的代码和结构保持不变,注释和说明精准翻译,请放心
使用
。
如题,项目A开发完毕后,回到项目B继续开发。当启动项目,输入http://localhost:8080/
swagger
-ui.html的时候,
swagger
首页显示空白。
项目A和项目B的
swagger
地址是相同的,输入
swagger
首页地址,由于浏览器缓存的原因,导致访问的仍旧是项目A的
swagger
,而项目A并未启动,所以显示空白。
解决方案:
f12,清空缓存并重新加载。
今天在个人springboot项目
使用
swagger
时遇到页面始终空白的问题,就顺便贴个博文,简单写下springboot集成
swagger
,并记录下问题。
1. 引入依赖包
<dependency>
<groupId>io.springfox</groupId>
<artifactId>springfox-
swagger
2<...
Springboot整合
swagger
2时后,访问http://localhost:8080/
swagger
-ui.html时
出现
空白页
我的
swagger
2版本为2.7.0。
Swagger
2的maven版本为2.7.0
<dependency>
<groupId>io.springfox</groupId>
<artifactId>springfox-
swagger
2</artifactId>
<versio
配置类
Swagger
Config需继承WebMvcConfigurationSupport,上面的四个注解不能少。
然后检查web.xml中为dispatherServlet设置的拦截路径
在这里解释一下/和/* 的区别:
< url-pattern > / </ url-pattern > 除*.jsp外,所有请求都被dispatcherServlet 拦截;如果在springmvc的配置文件中未设置对应的mapping,静态资源是访问不了
1. 没有正确配置
Swagger
的API文档路径。请检查
Swagger
配置文件中的API文档路径是否正确。
2.
Swagger
的API文档路径没有生成或者生成失败。请检查
Swagger
的API文档是否已经生成,并且是否生成成功。
3. 浏览器缓存问题。请尝试清除浏览器缓存,或者
使用
其他浏览器访问
Swagger
页面。
4.
Swagger
-UI版本问题。请检查
Swagger
-UI的版本是否与
Swagger
的版本匹配。
希望以上信息能够帮助您解决问题。
### 回答2:
当我们在
使用
Swagger
-UI展示API文档的时候,有时候会
出现
swagger
-ui.html页面空白的情况。这种情况通常是由以下几个方面原因:
1、版本不兼容:
swagger
-ui.html页面空白的可能原因之一是版本不兼容。只要在你的项目中有用到与
Swagger
-UI版本不兼容的第三方库或者框架,都有可能导致
Swagger
-UI页面空白的问题。
2、资源文件缺失:
Swagger
-UI是一个基于HTML、CSS、JavaScript编写的Web应用程序,它需要一些资源文件才能展示文档。如果在你的项目中某些资源文件缺失,例如:CSS样式、JavaScript脚本或者图标等,都有可能导致
Swagger
-UI页面空白。
3、配置问题:
Swagger
-UI的配置往往也会对页面生成造成影响。如果在你的
Swagger
-UI配置文件中存在某些错误配置,例如:缺少必要的参数或者参数设置不正确等,都有可能导致页面空白。
针对以上的问题,可以尝试以下解决方法:
1、检查项目中与
Swagger
-UI有关的第三方库或框架的版本是否兼容。
2、检查项目中的资源文件是否完整,如果缺失则需要重新下载资源文件。
3、检查
Swagger
-UI配置文件是否存在问题,可以采用排查问题的方式来确定问题所在并进行修正。
此外,可以查看网站控制台是否有报错信息,以便找出问题并解决。一旦问题得到解决,
Swagger
-UI页面就会正常展示API文档。
### 回答3:
当您在
使用
Swagger
UI时,可能会
出现
页面空白的问题。这种情况下,您需要采取以下步骤来解决:
1. 检查网络连接:
Swagger
UI需要从网络上加载所需的资源,如果您的网络连接
出现
问题,页面就会无法加载。请确保您的网络连接正常运作。
2. 检查浏览器兼容性:
Swagger
UI需要
使用
现代浏览器,如果您的浏览器版本过旧,页面可能无法正确加载。请升级您的浏览器版本,并确保它能够与
Swagger
UI兼容。
3. 检查
Swagger
UI版本:如果您
使用
的
Swagger
UI版本过旧,页面也可能
出现
空白的问题。请确保您
使用
的是最新的
Swagger
UI版本。
4. 检查
Swagger
规范:
Swagger
UI需要加载
Swagger
文件,如果您的
Swagger
文件内容有误,也会导致页面无法加载。请检查您的
Swagger
文件内容是否正确。
5. 清除缓存:在一些情况下,浏览器的缓存可能会导致
Swagger
UI页面
出现
问题。请清除您的浏览器缓存,然后再尝试打开
Swagger
UI。
如果您尝试以上方法依然无法解决问题,您可以提供更多具体的错误信息,以便我们更好的帮助您解决。