springmvc + swagger自动生成api集成问题

最新推荐文章于 2022-05-07 22:54:11 发布

酸酸的酸酸酱

最新推荐文章于 2022-05-07 22:54:11 发布

阅读量302

点赞数

CC 4.0 BY-SA版权

分类专栏：工作学习

本文链接：https://blog.youkuaiyun.com/zhangyuxuan2/article/details/88314144

工作学习专栏收录该内容

4 篇文章

订阅专栏

本文详细介绍了如何在项目中集成Springfox Swagger2，并解决了常见的依赖冲突问题，包括NoClassDefFoundError和NoSuchMethodError错误，通过调整版本和引入额外的依赖来确保API文档的正确生成。

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

maven依赖

  <!-- springfox swagger2 -->
		<dependency>
		    <groupId>io.springfox</groupId>
		    <artifactId>springfox-swagger2</artifactId>
		    <version>2.9.2</version>
		</dependency>
		
		<!-- UI生成 -->
		<dependency>
		    <groupId>io.springfox</groupId>
		    <artifactId>springfox-swagger-ui</artifactId>
		    <version>2.9.2</version>
		</dependency>
		
		<!-- 支持识别JSR-303校验注解 -->
		<dependency>
		    <groupId>io.springfox</groupId>
		    <artifactId>springfox-bean-validators</artifactId>
		    <version>2.9.2</version>
		</dependency>

报错：
Exception sending context initialized event to listener instance of class com.jeeplus.modules.sys.listener.WebContextListener
java.lang.NoClassDefFoundError: com/fasterxml/classmate/members/ResolvedParameterizedMember
在这里插入图片描述

解决方法，引入jar包

	<dependency>  
	    <groupId>com.fasterxml</groupId>  
	    <artifactId>classmate</artifactId>  
	    <version>1.2.0</version>  
	</dependency>

报错：
Failed to start bean ‘documentationPluginsBootstrapper’; nested exception is java.lang.NoSuchMethodError: com.google.common.collect.FluentIterable.append(Ljava/lang/Iterable;)Lcom/google/common/collect/FluentIterable;

在这里插入图片描述
原因，版本不兼容，降低springfox版本到2.6.1就好了

及最终整合：

<!-- springfox swagger2 -->
		<dependency>
		    <groupId>io.springfox</groupId>
		    <artifactId>springfox-swagger2</artifactId>
		    <version>2.6.1</version>
		</dependency>
		<dependency>  
		    <groupId>com.fasterxml</groupId>  
		    <artifactId>classmate</artifactId>  
		    <version>1.2.0</version>  
		</dependency>
		<!-- UI生成 -->
		<dependency>
		    <groupId>io.springfox</groupId>
		    <artifactId>springfox-swagger-ui</artifactId>
		    <version>2.6.1</version>
		</dependency>
		
		<!-- 支持识别JSR-303校验注解 -->
		<dependency>
		    <groupId>io.springfox</groupId>
		    <artifactId>springfox-bean-validators</artifactId>
		    <version>2.6.1</version>
		</dependency>

配置类：

package com.jeeplus.common.config;

import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
import org.springframework.web.servlet.config.annotation.EnableWebMvc;
import springfox.documentation.builders.ApiInfoBuilder;
import springfox.documentation.builders.PathSelectors;
import springfox.documentation.builders.RequestHandlerSelectors;
import springfox.documentation.service.ApiInfo;
import springfox.documentation.spi.DocumentationType;
import springfox.documentation.spring.web.plugins.Docket;
import springfox.documentation.swagger2.annotations.EnableSwagger2;

/**
 * @author zhangyuxuan
 * @date 2019年3月7日
 */
@Configuration
@EnableWebMvc
@EnableSwagger2
public class Swagger2 {

  @Bean
  public Docket createRestApi() {
    return new Docket(DocumentationType.SWAGGER_2).apiInfo(apiInfo()).select()
        .apis(RequestHandlerSelectors.basePackage("com.jeeplus.modules.sys.web")).paths(PathSelectors.any()).build();
  }

  private ApiInfo apiInfo() {
    return new ApiInfoBuilder().title("标题").description("描述").version("1.0").build();
  }

}