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

最新推荐文章于 2025-05-06 16:16:22 发布

霍比特大狗

最新推荐文章于 2025-05-06 16:16:22 发布

阅读量6.8k

点赞数

文章标签： java

原文链接：https://blog.youkuaiyun.com/mryang125/article/details/99683271

版权

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