Swagger UI本地访问提示“Unable to infer base url”错误求解决方案

错误提示翻译：

无法推断基础URL。这种情况在使用动态Servlet注册或API位于API网关后方时很常见。

以下是几种常见的解决方法：

• 检查Swagger配置类的路径映射
  确保Swagger配置类（如Spring Boot中的SwaggerConfig）正确配置了API基础路径，可在Docket实例中设置pathMapping：

  @Bean
  public Docket api() {
      return new Docket(DocumentationType.SWAGGER_2)
              .select()
              .apis(RequestHandlerSelectors.basePackage("com.your.project.controller"))
              .paths(PathSelectors.any())
              .build()
              .pathMapping("/"); // 这里填写你的应用根路径，若有上下文路径则改为对应值
  }
  

• 匹配Servlet上下文路径访问
  如果你的应用配置了自定义Servlet上下文路径（比如application.properties中设置server.servlet.context-path=/demo），访问Swagger UI时要带上这个前缀，即访问http://localhost:8080/demo/swagger-ui.html，而非直接访问根路径下的Swagger页面。

• 修正动态Servlet注册配置
  若使用传统Spring MVC项目且手动注册Servlet，需确保Swagger相关Servlet映射正确，示例web.xml配置：

  <servlet>
      <servlet-name>ApiListingResource</servlet-name>
      <servlet-class>io.swagger.jaxrs.listing.ApiListingResource</servlet-class>
  </servlet>
  <servlet-mapping>
      <servlet-name>ApiListingResource</servlet-name>
      <url-pattern>/v2/api-docs</url-pattern>
  </servlet-mapping>
  

• 验证API文档接口可用性
  直接访问Swagger生成的API文档接口（通常是/v2/api-docs或/v3/api-docs），确认能正常返回JSON格式的文档内容。如果无法访问，说明后端API文档生成逻辑存在问题，需排查配置或依赖。

• 确保依赖版本兼容
  检查Swagger依赖与Spring框架版本是否匹配，比如Spring Boot 2.6及以上版本建议使用SpringDoc OpenAPI替代Springfox，避免因版本冲突导致的路径推断失败。

内容的提问来源于stack exchange，提问作者Souvik Khan