Spring Boot启动后Swagger报Unable to infer base url错误求解答及提问建议
2026-8-12
错误原因分析
1. 动态Servlet注册导致
如果你的Spring Boot应用通过代码动态注册Servlet（而非默认自动配置或配置文件指定），Swagger/OpenAPI无法自动识别API的基础路径，进而无法推断base url。
2. API网关代理场景
当应用部署在API网关（如Nginx、Spring Cloud Gateway）之后，请求经过网关转发时，原始请求的Host、Path会被网关修改，Swagger无法通过当前请求信息正确推断真实的API基础路径。
3. 自定义Servlet路径未配置
如果应用设置了自定义的server.servlet.context-path，但未在Swagger/OpenAPI配置中明确指定base-url，自动推断逻辑会失效。
4. 依赖版本不兼容
Spring Boot与Swagger（或SpringDoc OpenAPI）的版本不匹配，会导致自动推断base url的逻辑出现异常。
Stack Overflow规范提问指导
按以下结构组织问题，能更快获得有效解答：
1. 精准标题
直接点明技术栈和核心问题，比如：Spring Boot Swagger UI 报错：Unable to infer base url
2. 环境信息
- Spring Boot 具体版本（如
2.7.10） - Swagger/OpenAPI 依赖版本（如
springfox-boot-starter:3.0.0或springdoc-openapi-starter-webmvc-ui:2.2.0） - 应用部署方式（本地运行/网关后/容器部署）
- 关键配置（如
application.yml里的server.servlet.context-path值，网关转发规则）
3. 问题详情
- 操作步骤：启动应用后，访问哪个地址触发的错误（如
http://localhost:8080/swagger-ui/index.html） - 完整错误信息：直接粘贴你看到的那段英文提示，或翻译后的中文内容
- 截图补充：说明错误截图的核心内容（如“截图显示Swagger UI要求手动输入base url”）
4. 已尝试的解决方法
列出你已经试过的操作，比如：
- 尝试手动输入推断的base url，但仍无法正常加载API文档
- 检查过
server.servlet.context-path配置，确认路径正确 - 更换过Swagger依赖版本，但问题依旧
5. 关键代码片段
- Swagger/OpenAPI的配置类（如果自定义了配置）
application.properties/application.yml中的相关配置内容
内容的提问来源于stack exchange，提问作者error_09
相关产品推荐
相关产品推荐
