springboot接入springfox报错documentationPluginsBootstrapper

一、前言

简单理解：

swagger第一版：io.swagger
swagger第二版：io.swagger.core.v3
swagger第三版：open-api

二、正文

springboot2.7接入springfox-swagger2遇到的问题，以及解决方案_springboot 2.7 swagger-CSDN博客

documentationPluginsBootstrapper 错误 - 简书 (jianshu.com)

import org.springframework.beans.BeansException;
import org.springframework.beans.factory.config.BeanPostProcessor;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
import org.springframework.lang.NonNull;
import org.springframework.util.ReflectionUtils;
import org.springframework.web.servlet.mvc.method.RequestMappingInfoHandlerMapping;
import springfox.documentation.spring.web.plugins.WebFluxRequestHandlerProvider;
import springfox.documentation.spring.web.plugins.WebMvcRequestHandlerProvider;

import java.lang.reflect.Field;
import java.util.List;
import java.util.stream.Collectors;


@Configuration
public class SwaggerConfig {

    @Bean
    public BeanPostProcessor springfoxHandlerProviderBeanPostProcessor() {
        return new BeanPostProcessor() {

            @Override
            public Object postProcessAfterInitialization(@NonNull  Object bean, @NonNull 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");
                    assert field != null;
                    field.setAccessible(true);
                    return (List<RequestMappingInfoHandlerMapping>) field.get(bean);
                } catch (IllegalArgumentException | IllegalAccessException e) {
                    throw new IllegalStateException(e);
                }
            }
        };
    }
}

加入后启动正常，但是访问swagger的/v2/api-docs接口和/swagger-ui/index.html，发现没有获得数据，接口内容是空的。
这是通过搜索得到有几种解决方案
1、ShortVideoSwagger2的配置类增加@EnableWebMvc注解
2、ShortVideoSwagger2的配置类需要集成WebMvcConfigurationSupport
3、springboot的配置增加增加一下配置：spring.mvc.pathmatch.matching-strategy=ANT_PATH_MATCHER

通过试验得知，这三种方式都可以解决，但是前都有副作用的
1和2会破坏springboot对springwebmvc的自动装配，导致自定义的一些convertor或者ObjectMapper失效(@EnableWebMvc建议慎用，最好在非springboot项目中使用)。
3是因为springboot2.6以后版本的matching-strategy默认的改为了PATH_PATTERN_PARSER，把它改为ANT_PATH_MATCHER就可以了。注意：此方法在某些服务启动时会失效！这个方法治标不治本，只有在不使用 SpringBoot的执行器时，此功能才起作用。无论配置的匹配策略如何，执行器将始终使用基于路径模式的解析（也就是默认策略）。