记录springboot集成jwt后swagger3.0无法打开的问题

已于 2024-01-25 10:55:57 修改
阅读量939 收藏 12
点赞数 13
分类专栏： springboot+vue3.0 文章标签： spring boot 后端 java
于 2024-01-24 22:00:30 首次发布
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.csdn.net/qq_26631337/article/details/135832090
版权
作者在集成JWT令牌到SpringBoot+Vue的管理系统后遇到Swagger页面无法打开的问题，原因是SwaggerUI的/api-docs路径被JWT拦截。解决方法是在拦截规则中放行/v3/api-docs，避免浪费时间在类似问题上。
摘要由CSDN通过智能技术生成

背景

最近在撸一个springboot+vue的管理系统，后端服务集成了jwt令牌后，发现swagger页面打不开了，错误信息如下：

Unable to render this definition The provided definition does not specify a valid version field.
Please indicate a valid Swagger or OpenAPI version field. Supported version fields are swagger: “2.0” and those that match openapi: 3.0.n (for example, openapi: 3.0.0)

尝试了百度上的各种乱七八糟办法，都没什么卵用，在毫无头绪的情况下打开浏览器控制台，发现是因为sawgger页面下api-docs路径被jwt令牌拦截了...

发现在拦截中放行的请求中对swagger只放开了，/swagger-ui/**，/swagger-resources/**

加上/v3/api-docs后问题解决

总结

希望后面的同学看到后不要在这样的问题上再去浪费太多的时间...

不讲道理的柯里昂
关注
  • 13
    点赞
  • 踩
  • 12
    收藏
    觉得还不错? 一键收藏
  • 0
    评论
专栏目录
Swagger..Unable to render this definition The provided definition does not specify a valid version
Daioo 随笔
05-02 2万+
Unable to render this definition The provided definition does not specify a valid version field. Please indicate a valid Swagger or OpenAPI version field. Supported version fields are swagger: “2.0” ...
SpringBoot集成Swagger实现JWT验证token
qq_38586378的博客
06-04 4079
前言 最近有个项目涉及用户权限管理，然后之前也有看到的一个小技术JWT，简单学习了解以后结合SpringBoot Swagger实现了一个简单的demo，这个demo主要是实现用户通过用户名和密码登录系统，登录成功以后系统给一个token，之后的用户操作需要验证token，只有token符合要求才能进行其他系统资源访问操作，否则提示权限不够或者token过期有误等提示信息，现将实现过程进行简单记录。 参考链接 1. Swagger了解：https://www.jianshu.com/p/349e130
【已解决】Swagger报错：Unable to render this definition
热门推荐
cc920095705的博客
09-22 1万+
swagger报错：记录swagger报错：Unable to render this definition报错截图问题原因在controller中，有重复的@api导致无法识别（很遗憾，我遇到的不是这个）具体问题，具体分析在此记录，谢谢。 swagger报错：Unable to render this definition 报错截图 问题原因 在controller中，有重复的@api导致无法识别（很遗憾，我遇到的不是这个） 可以通过排查controller中的注解说明来去掉重复。 具体问题，具体分析
探秘Spring Boot JWT：安全、高效的认证解决方案
最新发布
gitblog_00013的博客
05-14 268
探秘Spring Boot JWT：安全、高效的认证解决方案 项目地址:https://gitcode.com/murraco/spring-boot-jwt 在这个数字化时代，安全的用户认证和授权是任何应用程序的基础。Spring Boot JWT 项目为你提供了一种简单而强大的方式，通过Java技术和JWT（JSON Web Token）实现这一目标。本文将详细介绍该项目，并探讨其技术优势以及...
java中swagger报错：Please indicate a valid Swagger or OpenAPI version field. Supported version fields ar
彭珂个人网的博客
04-01 6741
可以看到，有和我们提示信息一样的字眼 swagger 2.0 openApi 3.0。可以看到，已经可以正常打开使用了，当然如果还不行，你可以试下swagger 1.2的。
swagger-ui.html渲染出错：Please indicate a valid Swagger or OpenAPI version field
giser@2011的博客
07-21 1907
swagger-ui.html报错， The provided definition does not specify a valid version field. Please indicate a valid Swagger or OpenAPI version field. Supported version fields are swagger: "2.0" and those that match openapi: 3.0.n (for example, openapi: 3.0.0).
springboot 集成 swagger2 报错 Please indicate a valid Swagger or OpenAPI version field.
qq_34595792的博客
10-12 6327
由于是maven+springcloud 多模块项目，使用了gateway网关，并且添加了过滤器，验证token，需要在gateway中添加白名单：/admin/swagger-ui.html,/admin/swagger-resources/,/admin/webjars/,/admin/v2/**，重启即可通过gateway进行访问 ...
SpringBoot 3.x 整合 JWT 、Swagger（使用springdoc）
qq_58159506的博客
04-17 526
SpringBoot 3.x 整合 JWT 、Swagger（使用springdoc）
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；
IDEA+Springboot+Mybatis+MySql+Swagger3.0+JWT权限验证 的实现 增、删、改、查
09-03
在本项目中，我们主要利用IntelliJ IDEA作为开发集成环境（IDE），Spring Boot作为核心框架，Mybatis作为持久层框架，MySQL作为数据库存储，Swagger3.0用于API文档的生成与管理，以及JWT（JSON Web Tokens）进行权限...
Springboot整合JWT,Swagger.zip
07-12
SpringBoot整合JWT与Swagger是现代Web开发中两个重要的技术组件，它们可以极大地提升应用程序的效率和易用性。JWT（Json Web Token）用于安全地在客户端和服务器之间传输信息，而Swagger则是用于构建RESTful API的...
SpringBoot集成JWT生成token及校验方法过程解析
08-19
SpringBoot集成JWT生成token及校验方法过程解析 本文主要介绍了SpringBoot集成JWT生成token及校验方法的过程解析，通过示例代码详细介绍了JWT token的生成和校验过程，为读者提供了详细的Reference和学习价值。 一...
springboot集成jwt
01-25
**SpringBoot集成JWT详解** SpringBoot是一个轻量级的Java框架，它简化了Spring应用程序的创建和部署。JWT（Json Web Token）则是一种用于在各方之间安全地传输信息的开放标准，广泛应用于身份验证和授权场景。在...
springboot集成jwt和shiro实现前后端分离权限demo2
04-10
这个"springboot集成jwt和shiro实现前后端分离权限demo2"项目，旨在提供一个实际的案例，帮助开发者理解如何在Spring Boot应用中实现前后端分离的权限管理。通过学习和实践这个示例，你可以掌握JWT和Shiro的使用技巧...
swagger：遇到 Unable to render this definition错误(for example, openapi: 3.0.0).
miffy2017may的博客
03-14 2998
检查一下，果然是将两个不同的函数名称配成了同一个api名称(或者url 或者url 最后一个/后的匹配字段)，所以报这个错，开始以为是swagger的问题，后经同事指点，原来是Controller里面的api配置名称有重复。Controller的swagger配置有重复的时候就会遇到这个错误。
Unable to render this definition
我思故我在
01-17 4874
Swagger报错 Unable to render this definition1、Swagger页面报错截图2、产生原因分析和结论原因：添加新接口后Swagger接口异常结论：此版本的swagger前端无法正常解析带 “\” 格式的JSON报文3、 解决方案 1、Swagger页面报错截图 2、产生原因分析和结论 原因：添加新接口后Swagger接口异常 1.查看idea控制台，没有打印异常，排除接口异常； 2.浏览器页面F12查看接口情况，接口已经返回定义接口报文，但是前端报错，如图: 3、查看
swagger Unable to render this definition
支付宝转账20r看蟹黄堡配方 的博客
10-05 363
swagger Unable to render this definition springboot 下swagger 问题 解决方案： 1.检查controller层@ApiOperation是否存在冲突 2.拦截器配置问题 修改如下 @Override public void addInterceptors(InterceptorRegistry registry) { registry.addInterceptor(getLoginInterceptor())
swagger文档无法访问
benniaofei18的博客
04-15 1896
.
SpringBoot集成JWT
06-09
好的，我可以为您提供一些关于SpringBoot集成JWT的基本信息。 首先，JWT（JSON Web Token）是一种用于身份验证和授权的开放标准。它可以将用户信息编码为一个安全的JSON对象，并使用密钥对其进行签名，以确保其未被篡改。 在SpringBoot中集成JWT，您需要使用一个JWT库，例如JJwt或Nimbus-Jose-Jwt。这些库提供了一些工具来生成、验证和解析JWT。 以下是一些基本步骤： 1. 添加JWT库的依赖项到您的SpringBoot项目中。 2. 创建一个JWT工具类，该类包含生成、验证和解析JWT的方法。 3. 在您的应用程序中，当用户成功登录时，生成一个JWT并将其返回给客户端。 4. 当客户端发送请求时，将JWT包含在请求头中。 5. 创建一个拦截器，用于验证JWT是否有效。如果JWT无效，则拦截器将返回401未授权错误。 以上是基本的步骤，您可以根据您的需求进行更改和调整。希望这些信息能对您有所帮助！
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

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

抵扣说明：

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

余额充值