SpringBoot集成Swagger2出现Unable to infer base url.

最新推荐文章于 2025-02-26 21:46:39 发布
转载 最新推荐文章于 2025-02-26 21:46:39 发布 · 4.7k 阅读 · 1 ·
CC 4.0 BY-SA版权
原文链接：https://www.jianshu.com/p/d6c70c28f396
文章标签：

#java

本文介绍在SpringBoot项目中使用Swagger2进行接口发布时遇到的问题及解决方案。当使用maven打包并通过tomcat部署时，访问swagger-ui.html会出现无法推断baseUrl的错误。文章提供了解决方法，包括在Application类中添加@EnableSwagger2注解和继承SpringBootServletInitializer类。

现象：

SpringBoot集成Swagger2进行接口发布，SpringBoot版本：2.0.1，Swagger2版本：2.8.0

IDEA直接运行可以直接访问，但是maven打成war包通过tomcat发布，访问swagger-ui.html就会出现Unable to infer base url.的报错

解决方法：

不求甚解，尝试几种解决方法，问题解决

方法1、Application增加@EnableSwagger2注释

方法2、Application 继承 SpringBootServletInitializer类

Application extends SpringBootServletInitializer

一篇文章带你解决 Unable to infer base url. This is common when using dynamic servlet registra
南淮北安的博客
10-24 2万+
我这里使用的是2.10.2 版本的 swagger，这个版本将由于支持了WebFlux，所以之前的@EnableSwagger2就移除掉了，变为@EnableSwagger2WebMvc以及@EnableSwagger2WebFlux <dependency> <groupId>io.springfox</groupId> <artifactId>springfox-swagger2</artifa.
访问Swagger页面异常 Unable to infer base url.
Markix的博客
07-30 3729
访问Swagger页面无法正常显示，提示如下信息： Unable to infer base url. This is common when using dynamic servlet registration or when the API is behind an API Gateway. The base url is the root of where all the swagger resources are served. For e.g. if the api is available at
Swagger弹窗报错：Unable to infer base url. This is common when using dynamic servlet registration...
guocunlei的博客
11-25 2万+
一、前言 springboot集成swagger，所有配置都配置好之后，访问：http://localhost:8081/swagger-ui/index.html#/ 出现弹窗报错： 二、问题定位分析 1、 查看是否配置了拦截器，如果配置了，则放行swagger的相关请求 "/swagger-resources/**" ,"/webjars/**" ,"/v2/**" ,"/swagger-ui.html/**" 代码里未使用，此条排除 2、配置未加 看网上说的最多的就是在配置类上加 @EnableS
Swagger3被拦截器拦截并报错Unable to infer base url或者Unable to render this definition
sluck_0430的博客
04-14 1万+
Swagger3报错Unable to infer base url；Swagger3报错Unable to render this definition；Swagger3被拦截；拦截器与swagger3；
springboot集成swagger出现Unable to infer base url
qq_52444812的博客
02-26 322
原因是application.properties配置文件的server.port已经被修改。把8080改成对应的端口号。
SpringBoot使用Swagger3出现Unable to infer base url.This is common when using dynamic servlet
daihaoxin的专栏
04-13 7945
在使用`SpringBoot`中配置`Swagger3`的时候，出现 Unable to infer base url. This is common when using dynamic servlet registration or when the API is behind an API Gateway. The base url is the root of where all the swagger resources are served. For e.g. if the api is av
springboot3.x整合Swagger3.0 Swagger弹窗报错：Unable to infer base url. This is common
qq_66211468的博客
02-08 1189
springboot集成swagger，所有配置都配置好之后，访问：http://localhost:8081/swagger-ui/index.html#/出现弹窗报错：答主用的是jdK17-spring boot3.x小白有点不懂原理花费数个小时试过以下几种方式1、如果用的是jdk8-springboot2添加如下依赖并在配置类上加上注解2、如果你也和我一样头铁这么用的话jdK17-spring boot3.x。
springboot swagger配置，Unable to infer base url，拦截器问题
热门推荐
海洋专栏
10-18 4万+
swagger配置很简单，但是，因为使用到了拦截器，所以，就不简单了，刚开始怎么也不能显示接口列表，后来才发现是拦截器的问题，然后就各种方法的试试。刚开始是配置webmvc的静态资源类来过滤，但是后来发现还是不行。 后来仔细想想，配置了静态资源过滤，但是拦截器与这个什么webmvcconfigureadpter 是没有关系的，虽然配置了，也还是会拦截。然后，就放弃了webmvc适配器实现的方式，...
SpringBoot使用Swagger2提示Unable to infer base url错误
xdhc的博客
08-23 1万+
1、版本： swagger 2.7.0； 访问swagger首页 http://localhost:8080/swagger-ui.html，错误信息如下： Unable to infer base url. This is common when using dynamic servlet registration or when the API is behind an API Gateway...
Swagger弹窗报错：Unable to infer base url.
sushiyi651的博客
03-08 2912
springboot集成swagger，所有配置都配置好之后，访问：http://localhost:8080/swagger-ui/ 出现弹窗报错如下图： 2、未加@EnableSwagger2配置。3、项目中使用了全局统一处理类即@ControllerAdvice或ResponseBodyAdvice，会导致接口返回JSON数据格式和swagger期望的不一样，造成swagger报错。 解决方法很简单，在代码上加上你自己扫描包的范围，因为@ControllerAdvice主要是拦截controlle
Spring Boot整合Swagger2弹出提示Unable to infer base url.
Java精选
03-30 1263
Spring Boot整合Swagger2弹出提示Unable to infer base url. https://blog.yoodb.com/yoodb/article/detail/1581
[问题解决]Unable to infer base url. This is common when using dynamic servlet registration...
博客
09-21 2万+
解决使用swagger出现Unable to infer base url. This is common when using dynamic servlet registration... Localhost:8080的问题。
【Swagger笔记】Unable to infer base url
龙套的博客
07-28 1317
在进入Swagger接口测试界面时，弹出一个弹窗，内容：Unable to infer base url. …… 大体的意思为：Swagger获取不到它需要的资源，原因可以从两方面考虑： Swagger相关的配置没配置好。这种情况相关配置教程很多，请用自己喜欢的引擎搜索 Swagger没有获得访问路径的权限。例如之前刚配置好的权限管理，如Shiro、Security等，需要对Swagger请求访问的相关路径进行开放。相关路径如下： /swagger-ui.html /webjars/** /v2/
Unable to infer base url.
cry1049208942的专栏
05-05 598
访问swagger提示以下内容 http://localhost:8081/swagger-ui.html Unable to infer base url. This is common when using dynamic servlet registration or when the API is behind an API Gateway. The base url is the root of where all the swagger resources are served. .
Swagger-UI报Unable to infer base url
weixin_33894640的博客
03-25 469
　　准备给项目部署Swagger-UI，按照demo写好之后，服务运行起来，访问http://local IP:service port/swagger-ui.html报Unable to infer base url Google了一下，StackOverflow上说是获取不到Swagger需要的资源（https://stackoverflow.com/questions/4742...
swagger启动错误Unable to infer base url.
KJ_Study的博客
10-27 3038
一、swagger版本 <!--swagger jar包--> <dependency> <groupId>io.springfox</groupId> <artifactId>springfox-swagger-ui</artifactId> <version>2.9.2</version> </dependency> <dependency> <g
springboot swagger配置，Unable to infer base url
yangwy012210的博客
02-12 226
启动时添加注解： @EnableSwagger2
SpringBoot使用swagger出现“Unable to infer base url.”
乡村少年的程序人生
08-03 2527
springbboot集成swagger后，访问url报错Unable to infer base url.
springboot 配置 swagger 3, unable to infer base url
最新发布
06-26
在Spring Boot应用中配置Swagger 3时，若遇到“无法推断基础URL（Unable to infer base URL）”的问题，通常是因为Swagger无法正确识别当前服务的基础路径。以下是一些可能的解决方案： ### 配置`springdoc.openapi.urls`属性 如果应用部署在反向代理或网关之后，或者有多个上下文路径，可以通过显式指定OpenAPI文档的URL来解决此问题。在`application.properties`或`application.yml`中添加如下配置： #### application.properties ```properties springdoc.openapi.urls[0]=http://localhost:8080/v3/api-docs ``` #### application.yml ```yaml springdoc: openapi: urls: - http://localhost:8080/v3/api-docs ``` 这样可以确保Swagger UI能够正确加载OpenAPI描述文件[^1]。 ### 设置正确的服务器URL 在OpenAPI配置中，可以显式设置服务器URL以帮助Swagger UI正确识别基础路径。例如，在配置类中添加如下代码： ```java import io.swagger.v3.oas.models.OpenAPI; import io.swagger.v3.oas.models.servers.Server; import org.springframework.context.annotation.Bean; import org.springframework.context.annotation.Configuration; import java.util.List; @Configuration public class OpenApiConfig { @Bean public OpenAPI customOpenAPI() { return new OpenAPI() .servers(List.of(new Server().url("http://localhost:8080"))); } } ``` 通过这种方式，可以明确告诉Swagger当前服务的基础URL是什么，从而避免自动推断失败的情况。 ### 检查应用的上下文路径 如果应用配置了非默认的上下文路径（如`server.servlet.context-path=/myapp`），请确保在访问Swagger UI时也包含该路径。例如，如果上下文路径为`/myapp`，则应访问： ``` http://localhost:8080/myapp/swagger-ui.html ``` 同时，确保OpenAPI JSON描述文件的URL也包含上下文路径： ``` http://localhost:8080/myapp/v3/api-docs ``` ### 使用Nginx或反向代理时的配置 如果你的应用部署在Nginx或其他反向代理后面，并且通过代理访问服务，请确保代理正确传递了主机头和路径信息。可以在Nginx配置中添加如下内容以确保请求头正确传递： ```nginx location /swagger-ui/ { proxy_pass http://localhost:8080/swagger-ui/; proxy_set_header Host $host; proxy_set_header X-Real-IP $remote_addr; proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for; proxy_set_header X-Forwarded-Proto $scheme; } ``` ### 检查依赖版本 确保使用的`springdoc-openapi`版本与Spring Boot版本兼容。如果版本不匹配，可能会导致各种问题，包括基础URL无法推断。建议使用最新的稳定版本，如： ```xml <dependency> <groupId>org.springdoc</groupId> <artifactId>springdoc-openapi-starter-webmvc-ui</artifactId> <version>1.6.14</version> <!-- 请根据实际情况选择最新版本 --> </dependency> ``` ---
评论 2
成就一亿技术人!
拼手气红包6.0元
还能输入1000个字符
 
红包 添加红包
表情包 插入表情
表情包 代码片
 条评论被折叠 查看
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

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

抵扣说明：

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

余额充值