swagger文件上传处理的正确写法

最近接手一个项目的swagger文件上传接口无法直接调试

经过简单的修改之后达到可用效果

修改前写法：

    @PostMapping("/upload-image")
    @ApiOperation(value = "图片上传", notes = "图片上传", response = JsonResult.class)
    @ApiImplicitParams({
            @ApiImplicitParam(name = "attach", value = "上传文件", required = true, dataType = "File", paramType = "query"),
            @ApiImplicitParam(name = "type", value = "文件类型", required = true, dataType = "String", paramType = "query"),
            @ApiImplicitParam(name = "deviceId", value = "deviceId", required = true, dataType = "String", paramType = "query"),
            @ApiImplicitParam(name = "mobilePhone", value = "mobilePhone", required = true, dataType = "String", paramType = "query"),
            @ApiImplicitParam(name = "appName", value = "appName名称", required = true, dataType = "String", paramType = "query"),
            @ApiImplicitParam(name = "cardNo", value = "银行卡号,上传银行卡反面图片时必须填", required = false, dataType = "String", paramType = "query"),
    })
    @LoginAuth
    public JsonResult imageUpload(HttpServletRequest request,
                                  HttpServletResponse response,
                                  @RequestParam (value = "attach", required = true) MultipartFile file,
                                  String type,
                                  String deviceId,
                                  String mobilePhone,
                                  String appName,
                                  String cardNo) {

修改后写法：

 @PostMapping(value="/upload-image",headers="content-type=multipart/form-data")
    @ApiOperation(value = "图片上传", notes = "图片上传", response = JsonResult.class)
    @ApiImplicitParams({
            @ApiImplicitParam(name = "type", value = "文件类型,3:工作证，6:工牌照片，8:银行卡正面, 10:人脸识别，11:身份证正面，12:身份证反面,13:央行征信报告,14:银行卡反面", required = true, dataType = "String", paramType = "query"),
            @ApiImplicitParam(name = "deviceId", value = "deviceId", required = true, dataType = "String", paramType = "query"),
            @ApiImplicitParam(name = "mobilePhone", value = "mobilePhone", required = true, dataType = "String", paramType = "query"),
            @ApiImplicitParam(name = "appName", value = "appName名称", required = true, dataType = "String", paramType = "query"),
            @ApiImplicitParam(name = "cardNo", value = "银行卡号,上传银行卡反面图片时必须填", required = false, dataType = "String", paramType = "query"),
    })
    @LoginAuth
    public JsonResult imageUpload(HttpServletRequest request,
                                  HttpServletResponse response,
                                  @ApiParam(name = "attach",value = "attach", required = true) MultipartFile attach,
                                  String type,
                                  String deviceId,
                                  String mobilePhone,
                                  String appName,
                                  String cardNo)

修改点：