swagger-ui.html页面无法打开解决方案

1.@EnableWebMvc注解必须去掉。

2.实现WebMvcConfigurer,并添加如下代码

@Override
public void addResourceHandlers(ResourceHandlerRegistry registry) {
  registry.addResourceHandler("swagger-ui.html")
      .addResourceLocations("classpath:/META-INF/resources/swagger-ui.html");
  registry.addResourceHandler("/webjars/**")
      .addResourceLocations("classpath:/META-INF/resources/webjars/");
}

3.检查配置文件application.properties

1) 将如下配置去掉,或者改成true:

spring.resources.add-mappings=false

2) 将如下配置去掉:

spring.resources.static-locations: classpath:/webapp/

4.查看nginx配置

检查前端代码,发现nginx配置有如下一段:

location /api/swagger-ui.html{
        proxy_pass http://server-service:8080/;
        proxy_set_header X-Real-IP $remote_addr;
        client_max_body_size    1000m;
        }

由于当前应用部署在k8s环境中,后端的api地址恰好为http://server-service:8080/,所以这个配置会导致请求直接转发到后端接口,导致无法访问页面。

事实上,针对swagger,前端nginx不需要做任何映射,直接请求 http:// {后端公网host}/swagger-ui.html 即可访问。 

参考:

https://github.com/springfox/springfox/issues/1460
https://github.com/springfox/springfox/issues/2037
https://github.com/springfox/springfox/issues/2396

  • 0
    点赞
  • 0
    收藏
    觉得还不错? 一键收藏
  • 0
    评论
### 回答1: 可能是以下原因导致swagger-ui.html页面空白: 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。 如果您尝试以上方法依然无法解决问题,您可以提供更多具体的错误信息,以便我们更好的帮助您解决。

“相关推荐”对你有帮助么?

  • 非常没帮助
  • 没帮助
  • 一般
  • 有帮助
  • 非常有帮助
提交
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

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

抵扣说明:

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

余额充值