Failedtostartbean‘springfox.documentation.spring.web.plugins.DocumentationPluginsBootstrapper‘；_failed to start bean 'springfox.documentation.spri-优快云博客

本文链接：https://blog.youkuaiyun.com/Hey_Join/article/details/132179965

文章讲述了在SpringBoot2.6.x版本中集成Swagger3.0.0及以上时遇到的启动错误，涉及版本依赖、配置类修改以及BeanPostProcessor的使用，解决方法是调整处理映射的逻辑。

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

当你的spring-boot版本是2.6.x并且你的swagger版本是3.0.0以上的时候，项目启动会报错

swagger依赖
<dependency>
            <groupId>com.github.xiaoymin</groupId>
            <artifactId>knife4j-spring-boot-starter</artifactId>
            <version>3.0.2</version>
</dependency>

//配置文件
spring:
  mvc:
    pathmatch:
      matching-strategy: ant_path_matcher

在swagger配置类添加
 @Bean
    public static BeanPostProcessor springfoxHandlerProviderBeanPostProcessor() {
        return new BeanPostProcessor() {
 
            @Override
            public Object postProcessAfterInitialization(Object bean, String beanName) throws BeansException {
                if (bean instanceof WebMvcRequestHandlerProvider || bean instanceof WebFluxRequestHandlerProvider) {
                    customizeSpringfoxHandlerMappings(getHandlerMappings(bean));
                }
                return bean;
            }
 
            private <T extends RequestMappingInfoHandlerMapping> void customizeSpringfoxHandlerMappings(List<T> mappings) {
                List<T> copy = mappings.stream()
                        .filter(mapping -> mapping.getPatternParser() == null)
                        .collect(Collectors.toList());
                mappings.clear();
                mappings.addAll(copy);
            }
 
            @SuppressWarnings("unchecked")
            private List<RequestMappingInfoHandlerMapping> getHandlerMappings(Object bean) {
                try {
                    Field field = ReflectionUtils.findField(bean.getClass(), "handlerMappings");
                    field.setAccessible(true);
                    return (List<RequestMappingInfoHandlerMapping>) field.get(bean);
                } catch (IllegalArgumentException | IllegalAccessException e) {
                    throw new IllegalStateException(e);
                }
            }
        };
    }