Springboot整合Swagger3.0 冲突报错+完整demo

最新推荐文章于 2025-05-09 15:37:53 发布

原创

最新推荐文章于 2025-05-09 15:37:53 发布 · 1.8k 阅读

2 ·

CC 4.0 BY-SA版权

文章标签：

#spring boot #java #spring #swagger2

本文介绍了Springboot 2.6.2版本整合Swagger3.0时遇到的两个错误及解决方案。错误一涉及到Springboot 2.6.0中路径匹配策略的改变，解决方法是通过yaml配置恢复到AntPathMatcher。错误二在于API文档未显示，解决办法包括检查启动类位置、配置类扫描路径等。将启动类移至根目录后，Swagger成功显示。

摘要生成于 C知道，由 DeepSeek-R1 满血版支持，前往体验 >

Springboot整合Swagger3.0 冲突报错+完整demo

修正后的完整demo（springboot2.6.2+Swagger3.0）可以参考完整springboot 2.6.2 + swagger 3.0 demo

错误一

切记整合Swagger需要关注Springboot版本情况，我的初始版本是2.6.2，整合后抛出 Failed to start bean ‘documentationPluginsBootstrapper’; 的错误

Error starting ApplicationContext. To display the conditions report re-run your application with 'debug' enabled.
2022-01-13 14:24:57.177 ERROR 15040 --- [           main] o.s.boot.SpringApplication               : Application run failed

org.springframework.context.ApplicationContextException: Failed to start bean 'documentationPluginsBootstrapper'; nested exception is java.lang.NullPointerException
	at org.springframework.context.support.DefaultLifecycleProcessor.doStart(DefaultLifecycleProcessor.java:181) ~[spring-context-5.3.14.jar:5.3.14]
	at org.springframework.context.support.DefaultLifecycleProcessor.access$200(DefaultLifecycleProcessor.java:54) ~[spring-context-5.3.14.jar:5.3.14]
	at org.springframework.context.support.DefaultLifecycleProcessor$LifecycleGroup.start(DefaultLifecycleProcessor.java:356) ~[spring-context-5.3.14.jar:5.3.14]
	at java.lang.Iterable.forEach(Iterable.java:75) ~[na:1.8.0_191]
	at org.springframework.context.support.DefaultLifecycleProcessor.startBeans(DefaultLifecycleProcessor.java:155) ~[spring-context-5.3.14.jar:5.3.14]
	at org.springframework.context.support.DefaultLifecycleProcessor.onRefresh(DefaultLifecycleProcessor.java:123) ~[spring-context-5.3.14.jar:5.3.14]
	at org.springframework.context.support.AbstractApplicationContext.finishRefresh(AbstractApplicationContext.java:935) ~[spring-context-5.3.14.jar:5.3.14]
	at org.springframework.context.support.AbstractApplicationContext.refresh(AbstractApplicationContext.java:586) ~[spring-context-5.3.14.jar:5.3.14]
	at org.springframework.boot.web.servlet.context.ServletWebServerApplicationContext.refresh(ServletWebServerApplicationContext.java:145) ~[spring-boot-2.6.2.jar:2.6.2]
	at org.springframework.boot.SpringApplication.refresh(SpringApplication.java:730) [spring-boot-2.6.2.jar:2.6.2]
	at org.springframework.boot.SpringApplication.refreshContext(SpringApplication.java:412) [spring-boot