前言

这是SpringCloud整合Swagger2的第一个坑。对于Swagger2这种技术其实没太多必要深入学习,知道怎么整合,集成微服务,一些注解的使用即可,不用像其他的一些框架一样,如Spring、SpringBoot这种就需要深入源码搞懂底层逻辑!

报错

***************************
APPLICATION FAILED TO START
***************************

Description:

An attempt was made to call the method org.springframework.plugin.core.PluginRegistry.getPluginFor(Ljava/lang/Object;)Ljava/util/Optional; but it does not exist. Its class, org.springframework.plugin.core.PluginRegistry, is available from the following locations:

    jar:file:/C:/Users/TAO/.m2/repository/org/springframework/plugin/spring-plugin-core/1.2.0.RELEASE/spring-plugin-core-1.2.0.RELEASE.jar!/org/springframework/plugin/core/PluginRegistry.class

It was loaded from the following location:

    file:/C:/Users/TAO/.m2/repository/org/springframework/plugin/spring-plugin-core/1.2.0.RELEASE/spring-plugin-core-1.2.0.RELEASE.jar


Action:

Correct the classpath of your application so that it contains a single, compatible version of org.springframework.plugin.core.PluginRegistry

首先这个问题产生的原因我说一下:由于Spring启动需要PluginRegistry类,但是在spring-plugin-core-1.2.0.RELEASE.jar 中找不到PluginRegistry,意思也就是说我们的spring-plugin-core这个依赖的版本高了,或者是低了,但是一般都是版本过低导致的!

微服务整合Swagger2

项目结构
SpringCloud整合Swagger2报错compatible version of org.springframework.plugin.core.PluginRegistry_jar

pom依赖
我这里只演示Swagger2整合相关的核心依赖

	<parent>
        <artifactId>yy-common</artifactId>
        <groupId>com.tao</groupId>
        <version>1.0-SNAPSHOT</version>
    </parent>
    <modelVersion>4.0.0</modelVersion>
    <description>yy swagger</description>
    <artifactId>yy-swagger</artifactId>

     <dependencies>
        <dependency>
            <groupId>io.springfox</groupId>
            <artifactId>springfox-swagger2</artifactId>
            <version>${swagger.fox.version}</version>
        </dependency>
        <dependency>
            <groupId>io.springfox</groupId>
            <artifactId>springfox-swagger-ui</artifactId>
            <version>${swagger.fox.version}</version>
        </dependency>
    </dependencies>

User项目导入Swagger2依赖
SpringCloud整合Swagger2报错compatible version of org.springframework.plugin.core.PluginRegistry_其他_02

编写相应的SwaggerAutoConfig配置类
这个我就不提供代码了,网上多的是,按照通用的代码copy一下即可

启动
启动后那么你就会看到上面的报错

问题分析

思路
首先报错中有这么一段信息Correct the classpath of your application so that it contains a single, compatible version of org.springframework.plugin.core.PluginRegistry,这个报错信息已经可以注意告诉我们这里的导包有问题,然后上面有个提示有问题的包org/springframework/plugin/spring-plugin-core/1.2.0.RELEASE/spring-plugin-core-1.2.0.RELEASE.jar,对就是这个jar包!我们右键User项目的pom文件查看依赖关系!
SpringCloud整合Swagger2报错compatible version of org.springframework.plugin.core.PluginRegistry_jar_03
Ctrl+F查找一下这个版本有问题的依赖spring-plugin-core-1.2.0.RELEASE.jar
SpringCloud整合Swagger2报错compatible version of org.springframework.plugin.core.PluginRegistry_其他_04
找到这个spring-plugin-core-1.2.0.RELEASE.jar版本有问题的依赖了,然后我们顺瓜摸藤,到他的引用处
SpringCloud整合Swagger2报错compatible version of org.springframework.plugin.core.PluginRegistry_spring_05
问题就在这个springfox-swagger2的依赖中!那么我们就有解决方案了,而且有多种

  1. 在swagger2项目中将springfox-swagger2依赖中的这个依赖spring-plugin-core手动排除
  2. 在父pom中指定依赖spring-plugin-core的版本推荐使用,因为便于后期统一维护

解决问题
SpringCloud整合Swagger2报错compatible version of org.springframework.plugin.core.PluginRegistry_其他_06

			<dependency>
                <groupId>org.springframework.plugin</groupId>
                <artifactId>spring-plugin-core</artifactId>
                <version>2.0.0.RELEASE</version>
            </dependency>

补充
如果项目中像我这里一样还整合了SpringSecurity的话,建议使用第二种方式处理,因为在SpringSecurity中也存在一个spring-plugin-core