springboot整合swagger3.0.0启动项目报错(版本兼容问题解决)

时间:2025-03-20 07:12:31

????致敬读者

  • ????感谢阅读
  • ????希望我的文章能帮到您
  • ????如有兴趣可点关注了解更多内容

????博主信息

  • ????点标题有惊喜

????文章前言

  • ????文章均为学习和工作中整理的笔记,分享记录为主,如有错误请指正,共同学习进步。
  • ????本文主要介绍springboot整合swagger3.0.0启动项目报错的解决

文章目录

  • ????致敬读者
  • ????博主信息
  • ????文章前言
  • 1. 场景
  • 2. 报错
  • 3. 原因
  • 4. 解决
  • ????文末寄语


以下方式可以解决大多数版本兼容问题

1. 场景

项目使用spring boot整合swagger3.0.0版本后启动项目报错

2. 报错

控制台输出报错内容为:

 Failed to start bean 'documentationPluginsBootstrapper'; nested exception is java.lang.NullPointerException

3. 原因

版本不兼容(可能的原因:SpringBoot2.6.0开始,请求路径与SpringMVC处理映射匹配的默认策略已从AntPathMatcher更改为PathPatternParser。可以通过设置-strategy为ant-path-matcher来改变。)

4. 解决

在文件中配置如下

spring:
  mvc:
    pathmatch:
      #这里配置的这个参数是为了解决spring boot和swagger版本不兼容的问题
      matching-strategy: ant_path_matcher

这样配置后可解决大部分版本的报错问题
目前自己试过的与swagger3.0.0兼容的spring boot可用版本为2.5.62.6.32.6.52.7.3
其余可用版本可自行尝试
试过的不可用版本为spring boot 2.3., 3.0.4


如果配置文件是则配置为

spring.mvc.pathmatch.matching-strategy=ant_path_matcher

????文末寄语

  • ????茫茫人海,相识即是有缘
  • ????拥抱科技,学习永无止步
  • ????创作不易,分享永不设限
  • ????如有收获,望君一键三连


????版权声明:

  • ????作者:为好全栈
  • ????博客地址:/
  • ????版权:本作品采用《创作共享许可证》进行许可,根据该许可授权的内容可在符合本许可证条款的前提下*使用、修改和创作衍生作品。

????版权许可介绍:

  • ????本文采用CC BY-NC-SA许可证
  • ????此许可允许在使用者仅出于非商业目的以任何媒体或格式分发、重新混合、改编和构建材料,并且前提是注明创作者。
  • ????如果您重新混合、改编或基于该材料进行构建,则必须按照相同的条款对修改后的材料进行许可。

????更多版权信息请访问以下网址查看:

  • ????版权官网 /licenses/by-nc-sa/4.0/
  • ????中文翻译 /licenses/by-nc-sa/4.0/-hans