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/**");
 }
 

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

發表評論
所有評論
還沒有人評論,想成為第一個評論的人麼? 請在上方評論欄輸入並且點擊發布.
相關文章