nutz-swagger json/yaml页面报错 参数不显示等

时间:2024-10-12 19:38:28

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


文章目录

  • 不多说废话,大牛的样例
  • 一、页面报错
    • 1、 url,json格式也可以写成是yaml格式,即./。
    • 2、包路径,是swagger接口路径,有swagger注解的类
  • 二、参数不显示
  • 三、超时报错
    • 1.考虑是拦截的问题
    • 2.缺少commons-lang3-3.9jar
  • 总结


不多说废话,大牛的样例

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

一、页面报错

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

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

在这里插入图片描述

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

在这里插入图片描述
因为这样他就会只扫描,你配置的路径下的类,有哪些符合swagger接口编写标准。如果是公司项目的话一般是。

二、参数不显示

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

三、超时报错

1.考虑是拦截的问题

2.缺少commons-lang3-3.9jar

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

在这里插入图片描述
打在日志里的话就是超时报错。


总结

debug是王道。