swagger2使用踩过的坑

    在项目中使用swagger2生成API确实为程序员带来了很多福音，但是在使用过程中，可能会遇到这样那样的坑，网上关于swagger2的介绍也有很多，本篇记录个人在使用过程中踩过的坑，高手可以忽略，不喜勿喷。

 1. 访问swagger的首页swagger-ui.html 时报错404。

  本地访问时，查看swagger的配置是否被扫描到，以及使用的swagger注解是否正确完善。

 2. 能访问首页但是不出接口

   要查看扫描包的路径有没有错误。

 3. 访问swagger首页成功，但是后台报错

没有进行任何的接口访问，但是却出现了NumberFormatException的错误，经了解个人认为这个算是swagger2.9.2的一个bug吧。

解决办法参考博客：https://blog.csdn.net/u011251198/article/details/104920619/

4. Could not resolve reference because of: Could not resolve pointer: /definitions/String does not exist in document

  根据错误信息显示的是接口的问题，此时要检查swagger注解中配置的参数变量和方法的形参变量是否一致，有时在复制粘贴时或许会有失误。

5. 项目配置登录拦截后，导致swagger的静态资源访问不了。

   把swagger的静态资源解除拦截：.excludePathPatterns("/swagger-resources/**", "/swagger-ui.html/**");

  @Override
  public void addInterceptors(InterceptorRegistry registry) {
      registry.addInterceptor(loginInterceptor).addPathPatterns("/**")
             .excludePathPatterns("/swagger-resources/**", "/swagger-ui.html/**");
 }
 

不积跬步无以至千里，后续遇到问题会继续总结更新。相信正在努力的你也一定会在这条路上走的更远更好更稳！！！