Gateway 整合 swagger 踩坑

注意版本问题，这里的swagger-bootstrap-ui依赖版本使用1.8.9不要使用1.9.6，不然不会加载 /swagger-resource

		
            io.springfox
            springfox-swagger2
            2.9.2
        
        
            io.springfox
            springfox-swagger-ui
            2.9.2
        
        
            com.github.xiaoymin
            swagger-bootstrap-ui
            1.8.9
        

第一种、手动配置各个模块的swagger api 路径

@Component
public class SwaggerProvider implements SwaggerResourcesProvider {

    @Override
    public List get() {
        List resources = new ArrayList<>();
        
        resources.add(swaggerResource("商品系统", "/goods/v2/api-docs", ""));
        resources.add(swaggerResource("后台系统", "/api/v2/api-docs", ""));
        return resources;
    }

    private SwaggerResource swaggerResource(String name, String location, String version) {
        SwaggerResource swaggerResource = new SwaggerResource();
        swaggerResource.setName(name);
        swaggerResource.setLocation(location);
        swaggerResource.setSwaggerVersion(version);
        return swaggerResource;
    }
}

第二种：根据Gateway的application.yml文件的映射路径自动获取所有模块的swagger文档

@Component
    public class MySwaggerResourceProvider implements SwaggerResourcesProvider {
    
        
        private static final String SWAGGER2URL = "/v2/api-docs";
    
        
        private final RouteLocator routeLocator;
    
        
        @Value("${spring.application.name}")
        private String self;
    
        @Autowired
        public MySwaggerResourceProvider(RouteLocator routeLocator) {
            this.routeLocator = routeLocator;
        }
    
        @Override
        public List get() {
            List resources = new ArrayList<>();
            List routeHosts = new ArrayList<>();
            // 由于我的网关采用的是负载均衡的方式，因此我需要拿到所有应用的serviceId
            // 获取所有可用的host：serviceId
            routeLocator.getRoutes().filter(route -> route.getUri().getHost() != null)
                    .filter(route -> !self.equals(route.getUri().getHost()))
                    .subscribe(route -> routeHosts.add(route.getUri().getHost()));
    
            // 记录已经添加过的server，存在同一个应用注册了多个服务在nacos上
            Set dealed = new HashSet<>();
            routeHosts.forEach(instance -> {
                // 拼接url，样式为/serviceId/v2/api-info，当网关调用这个接口时，会自动通过负载均衡寻找对应的主机
                String url = "/" + instance + SWAGGER2URL;
                if (!dealed.contains(url)) {
                    dealed.add(url);
                    SwaggerResource swaggerResource = new SwaggerResource();
                    swaggerResource.setUrl(url);
                    swaggerResource.setName(instance);
                    resources.add(swaggerResource);
                }
            });
            return resources;
        }
    }

swagger-bootstrap-ui依赖版本使用1.8.9，不然不会自动加载 /swagger-resource

@RestController
@RequestMapping("/swagger-resources")
public class SwaggerResourceController {

    private SwaggerProvider swaggerProvider;

    // TODO: 添加权限校验
    @Autowired
    public SwaggerResourceController(SwaggerProvider swaggerProvider) {
        this.swaggerProvider = swaggerProvider;
    }

    @RequestMapping(value = "/configuration/security")
    public ResponseEntity securityConfiguration() {
        return new ResponseEntity<>(SecurityConfigurationBuilder.builder().build(), HttpStatus.OK);
    }

    @RequestMapping(value = "/configuration/ui")
    public ResponseEntity uiConfiguration() {
        return new ResponseEntity<>(UiConfigurationBuilder.builder().build(), HttpStatus.OK);
    }

    @RequestMapping
    public ResponseEntity> swaggerResources() {
        return new ResponseEntity<>(swaggerProvider.get(), HttpStatus.OK);
    }
}

一定要去前缀，要保证访问各个微服务的路径是 /v2/api-docs，不然访问不到，或者在其他微服务 controller 层配置路径映射，映射到 /v2/api-docs

    gateway:
      routes:
        - id: goods_route
          uri: lb://fresh-goods
          predicates:
            - Path=/goods/**
          filters:
            - StripPrefix=1

        - id: system_route
          uri: lb://fresh-system
          predicates:
            - Path=/api/**
          filters:
            - StripPrefix=1

各个模块配置类似，只举例一个

@Configuration
@EnableSwagger2
@EnableSwaggerBootstrapUI
public class SwaggerConfig {

    @Bean
    public Docket createRestApi() {
        return new Docket(documentationType.SWAGGER_2)
                .apiInfo(apiInfo())
                .select()
                .apis(RequestHandlerSelectors.basePackage("com.monster.fresh.goods.controller"))//扫描地址
                .paths(PathSelectors.any())
                .build();
    }
    private ApiInfo apiInfo() {
        return new ApiInfoBuilder()
                .title("系统")
                .description("商品api文档")
                .version("1.0")
                .build();
    }
}

https://blog.csdn.net/xiaojin21cen/article/details/78654652