在项目中使用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注解中配置的参数变量和方法的形