nutz-swagger json/yaml走过的坑

另,有错误的地方也请大家指出来,共勉。


文章目录


不多说废话,大牛的样例

https://github.com/nutzam/nutzmore/tree/master/nutz-integration-swagger

一、页面报错

考虑是demo没写对,大牛的案例当中给了两个自己发挥的地方。

1、 url,json格式也可以写成是yaml格式,即./swagger.yaml。

nutz-swagger json/yaml走过的坑

2、包路径,是swagger接口路径,有swagger注解的类

nutz-swagger json/yaml走过的坑
因为这样他就会只扫描,你配置的路径下的类,有哪些符合swagger接口编写标准。如果是公司项目的话一般是com.xxx.xxx.xxx。

二、参数不显示

这就涉及到swagger编写标准了,@ApiImplicitParams不加在@ApiImplicitParam外面是不会显示的。

三、超时报错

1.考虑是拦截的问题

2.缺少commons-lang3-3.9jar

nutz-swagger json/yaml走过的坑
这个图片是maven加载pom之后的jar包清单。
有一个隐藏的类,commons-lang3-3.9jar,必须是3.9之后的版本。如果你的后台报lang的错,那么多半是他的问题。这个问题我排查了一天,只能单独使用@ApiImplicitParam,只要外面包上@ApiImplicitParams就会报错,而我检查了我的写法,看了很多经验贴,我确定我写的没有问题,就debug走了,发现是调用的方法找不到。
nutz-swagger json/yaml走过的坑

nutz-swagger json/yaml走过的坑
打在日志里的话就是超时报错。


总结

debug是王道。

上一篇:yaml


下一篇:容器编排——部署kubernetes可视化dashboard