记:一次代码写法导致在线文档(Swagger)Bug

Scroll Down

在使用Swagger的过程中,突然发现一个接口,重复显示了N次。

1.png
经过一番排除,发现是代码不规范的原因导致。

    @ApiOperation("各病xxxx")
    @ResponseBody
    @RequestMapping(value = "/xxx")
    public void xxx(@RequestParam Userparam) {
        
    }

就是因为在:@RequestMapping(value = "/xxx")没有明确是Post,还是Get

解决方案:使用
1. @GetMapping(value = "/xxx")
2. @PostMapping(value = "/xxx")
3. @RequestMapping(value = "/xxx", method = RequestMethod.GET)
明确指明即可。


    @ApiOperation("各病xxxx")
    @ResponseBody
    @RequestMapping(value = "/xxx")
    public void xxx(@RequestParam Userparam) {
        
    }

这样就能正常显示了。