Springfox升级后swagger-ui.html无法推断基础URL问题咨询

我之前维护网关后的Spring Boot服务时，刚好碰到过一模一样的情况！升级到Spring Boot 1.5.7 + Springfox 2.8.0后，Swagger UI弹出Unable to infer base url的提示，核心原因确实是缺失必要的Cookie——新版本的Swagger自动推断Base URL的逻辑更依赖请求中的Cookie信息，网关没正确传递的话就识别不了服务的实际访问路径。

下面是亲测有效的解决步骤：

1. 手动指定Swagger的Base URL #

绕过自动推断的坑，直接在Swagger配置里硬编码网关后的服务访问路径：

@Configuration
@EnableSwagger2
public class SwaggerConfig {
    @Bean
    public Docket api() {
        return new Docket(DocumentationType.SWAGGER_2)
                .select()
                .apis(RequestHandlerSelectors.basePackage("com.your.service.package"))
                .paths(PathSelectors.any())
                .build()
                .apiInfo(buildApiInfo())
                // 替换成你的网关域名+服务路由路径
                .host("your-gateway-domain.com/your-service-context-path");
    }

    private ApiInfo buildApiInfo() {
        return new ApiInfoBuilder()
                .title("你的服务API文档")
                .description("网关部署下的服务接口说明")
                .version("1.0")
                .build();
    }
}

2. 配置网关传递完整Cookie #

既然问题根源是Cookie缺失，得确保网关把请求里的Cookie完整传给后端服务：

• 如果用Spring Cloud Gateway，在路由规则里添加保留Cookie的配置，比如用PreserveHostHeaderGatewayFilterFactory或者自定义过滤器传递Cookie
• 如果是Nginx网关，在反向代理配置里加上proxy_set_header Cookie $http_cookie;，保证Cookie不丢失

3. 修复Swagger静态资源映射（可选） #

如果网关对静态资源路径有重写，可能还需要调整Spring Boot的静态资源映射，确保Swagger UI的css、js等资源能正确加载：

@Configuration
public class WebMvcConfig extends WebMvcConfigurerAdapter {
    @Override
    public void addResourceHandlers(ResourceHandlerRegistry registry) {
        registry.addResourceHandler("swagger-ui.html")
                .addResourceLocations("classpath:/META-INF/resources/");

        registry.addResourceHandler("/webjars/**")
                .addResourceLocations("classpath:/META-INF/resources/webjars/");
    }
}

验证效果 #

重启服务后访问Swagger UI页面：

• 检查是否不再弹出Unable to infer base url的提示框
• 随便调用一个接口，确认请求能正确路由到后端服务，返回正常响应

内容的提问来源于stack exchange，提问作者Arnab Gupta