swagger的坑

• 找不到getPluginFor
  NoSuchMethodError: org.springframework.plugin.core.PluginRegistry.getPluginFor
  springboot 2以上，就不要用 swagger 3以上的版本，springboot不可能降版本，把swagger降到2.92,不要用最新的

		<dependency>
			<groupId>io.springfox</groupId>
			<artifactId>springfox-swagger2</artifactId>
			<version>2.9.2</version>
		</dependency>
		<dependency>
			<groupId>io.springfox</groupId>
			<artifactId>springfox-swagger-ui</artifactId>
			<version>2.9.2</version>
		</dependency>

参考https://stackoverflow.com/questions/59703461/nosuchmethoderror-org-springframework-plugin-core-pluginregistry-getpluginordef

• WebMvcConfigurationSupport、 WebMvcConfigurer得慎重
  在纯粹的后端组件里面用swagger，如果是springboot+thymeleaf+Security的就比较麻烦了，路径会乱成一团糟，各种404（可能有能解决的，但是比较麻烦）
• Jackson的问题
  我自己有个项目，全面改造成gson，所以排除了jackson-databind，swagger 是使用的Jackson ，还是得放出来吧(可能有避规这个问题的，但是实在不友好)

        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-web</artifactId>
<!--            <exclusions>-->
<!--                <exclusion>-->
<!--                    <groupId>com.fasterxml.jackson.core</groupId>-->
<!--                    <artifactId>jackson-databind</artifactId>-->
<!--                </exclusion>-->
<!--            </exclusions>-->
        </dependency>

• 记得关闭
  @ConditionalOnProperty (name = “swagger.enable”, havingValue = “true”)
  然后测试环境下的配置文件里面加
  swagger.enable=true
  生产环境不加，默认关闭

Unable to infer base url. This is common when using dynamic servlet registration or when the API is behind an API Gateway. The base url is the root of where all the swagger resources are served. For e.g. if the api is available at http://example.org/api/v2/api-docs then the base url is http://example.org/api/. Please enter the location manually: 

• 下载文件比如Excel或者上传文件等
  这个显然会出问题