news 2026/5/1 4:49:20

SpringBoot3+Springdoc:v3api-docs可以访问,html无法访问的解决方法

作者头像

张小明

前端开发工程师

1.2k 24
文章封面图
SpringBoot3+Springdoc:v3api-docs可以访问,html无法访问的解决方法

项目环境

springboot 3.3.4
pom.xml引用如下(springdoc相关的只有这一个,理论上说,要跑springdoc或者叫它swagger3,除了springboot,加这个就可以了,不需要任何配置类配置、application.properties/yaml配置!!)
(当然,你跑通了之后需要自定义配置了再配)

<dependency> <groupId>org.springdoc</groupId> <artifactId>springdoc-openapi-starter-webmvc-ui</artifactId> <version>2.6.0</version> </dependency>

问题描述

启动服务器之后:
v3/api-docs可以访问,并返回json数据。
/swagger-ui/index.html无法访问,报错404。

解决方法

spring配置类里配一下swagger-ui的资源路径,然后访问/swagger-ui/index.html就好了。
PS:路径里最后的5.17.14建议查一下自己引用的依赖是什么版本。

@SpringBootApplication public class SpringbootApplication implements WebMvcConfigurer { public static void main(String[] args) { SpringApplication.run(SpringbootApplication.class, args); } @Override public void addResourceHandlers(ResourceHandlerRegistry registry) { // 配置 Swagger UI 资源路径 registry.addResourceHandler("/swagger-ui/**") .addResourceLocations("classpath:/META-INF/resources/webjars/swagger-ui/5.17.14/"); } }

解决过程

  1. 先改日志级别 logging.level.root=debug
  2. 启动访问swagger-ui.html(这里被误导了,应该去swagger-ui/index.html,不过对排查没影响,排查后也明白过来了)
  3. 回去看服务器debug日志,发现在查找资源的时候,找的那些路径似乎没有swagger相关的资源路径,然后想起来之前查的哪个文里提到了swagger-ui.jar里的资源地址,然后顺着摸过去
  4. 欸,里面有个index.html,我觉得就是它了,然后印象里有另一个文里说了资源路径的配置方法,照着配一下资源路径,ojbk

展示

访问(我配的端口是18080):localhost:18080/swagger-ui/index.html
上方的搜索栏输入api-docs的网址,点击Explore即可。

版权声明: 本文来自互联网用户投稿,该文观点仅代表作者本人,不代表本站立场。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如若内容造成侵权/违法违规/事实不符,请联系邮箱:809451989@qq.com进行投诉反馈,一经查实,立即删除!
网站建设 2026/5/1 4:53:54

混元翻译1.5性能优化:提升翻译速度的5个技巧

混元翻译1.5性能优化&#xff1a;提升翻译速度的5个技巧 混元翻译模型&#xff08;HY-MT1.5&#xff09;是腾讯开源的新一代高性能翻译大模型&#xff0c;专为多语言互译场景设计。该系列包含两个核心版本&#xff1a;HY-MT1.5-1.8B 和 HY-MT1.5-7B&#xff0c;分别面向高效边…

作者头像 李华
网站建设 2026/5/1 4:54:08

SpringBoot+Mybatis-plus实现分页查询(一看就会)

分页查询就是实现前端能进行翻页功能实现、查询功能实现等比如这张图片里面搜索功能和底下翻页的功能、每页展示多少条数据的功能 都是由我们后端返回的参数 total、pages、records等前端接收实现的 意思是这些功能我们后端不仅要实现分页功能&#xff0c;前端接收我们返回的参…

作者头像 李华
网站建设 2026/5/1 4:54:10

PDF-Extract-Kit性能测评:处理1000页PDF仅需10分钟

PDF-Extract-Kit性能测评&#xff1a;处理1000页PDF仅需10分钟 1. 背景与评测目标 在学术研究、工程文档和企业知识管理中&#xff0c;PDF作为最通用的文档格式之一&#xff0c;其内容提取需求日益增长。然而&#xff0c;传统OCR工具往往难以应对复杂版式、数学公式、表格结构…

作者头像 李华
网站建设 2026/5/1 5:07:21

PDF-Extract-Kit一文详解:数学公式识别技术原理

PDF-Extract-Kit一文详解&#xff1a;数学公式识别技术原理 1. 技术背景与问题提出 在科研、教育和出版领域&#xff0c;PDF 文档中广泛包含大量数学公式。传统方法难以高效提取这些公式的语义信息&#xff0c;尤其当文档为扫描件或非结构化排版时&#xff0c;手动录入 LaTeX…

作者头像 李华
网站建设 2026/5/1 5:56:11

AI Agent:学习与适应、模型上下文协议

智能体进阶&#xff1a;学习与适应、模型上下文协议深度解析 在人工智能领域&#xff0c;智能体&#xff08;Agent&#xff09;模式是构建自主、交互式系统的核心。第9章“学习与适应”和第10章“模型上下文协议&#xff08;MCP&#xff09;”分别聚焦于智能体的自我进化能力和…

作者头像 李华
网站建设 2026/5/1 5:59:26

I2C多设备主从切换策略:实战讲解状态机实现

I2C多设备主从切换实战&#xff1a;用状态机打造高可靠通信系统在嵌入式开发中&#xff0c;你有没有遇到过这样的场景&#xff1f;一个MCU既要作为主设备定期采集多个传感器的数据&#xff0c;又要能随时响应上位机的配置请求——此时它必须瞬间切换成从设备。如果处理不当&…

作者头像 李华