快捷導(dǎo)航

Springboot+MultipartFile實(shí)現(xiàn)單文件,多文件批量上傳過程

更新時(shí)間：2025年07月24日 16:16:10 作者：抹香鯨之海

在Spring?Boot中,若需Swagger顯示文件上傳按鈕,需使用@Consumes注解指定Content-Type（如multipart/form-data）,以告知接口接受文件類型,此注解幫助Swagger正確識(shí)別請(qǐng)求參數(shù),確保功能展示完整

Springboot+MultipartFile單文件多文件批量上傳

代碼：

    /**
     * 文件上傳請(qǐng)求
     */
    /**
     * 文件上傳請(qǐng)求
     */
    @PostMapping(value ="upload", consumes = MediaType.MULTIPART_FORM_DATA_VALUE)
    @ApiOperation(value = "文件上傳請(qǐng)求")
    public R<SysFile> upload(@RequestPart("file") MultipartFile file)
    {
        try
        {
            // 上傳并返回訪問地址
            String url = sysFileService.uploadFile(file);
            SysFile sysFile = new SysFile();
            sysFile.setName(FileUtils.getName(url));
            sysFile.setUrl(url);
            return R.ok(sysFile);
        }
        catch (Exception e)
        {
            log.error("上傳文件失敗", e);
            return R.fail(e.getMessage());
        }
    }

    /**
     * 批量上傳
     * @param files
     * @return
     */
    @PostMapping(value ="batchUploadFile", consumes = MediaType.MULTIPART_FORM_DATA_VALUE)
    @ApiOperation(value = "文件上傳請(qǐng)求")
    public R<JSONArray> batchUploadFile(@RequestPart("files") MultipartFile[] files)
    {
        try
        {
            JSONArray jsonArray=new JSONArray();

            for(MultipartFile file : files) {//循環(huán)單個(gè)上傳
                // 上傳并返回訪問地址
                String url = sysFileService.uploadFile(file);
                SysFile sysFile = new SysFile();
                sysFile.setName(FileUtils.getName(url));
                sysFile.setUrl(url);
                jsonArray.add(sysFile);
            }
            return R.ok(jsonArray);
        }
        catch (Exception e)
        {
            log.error("上傳文件失敗", e);
            return R.fail(e.getMessage());
        }
    }

Springboot里面要用這個(gè)標(biāo)簽接受文件，不然swagger上可能沒有按鈕。

@PostMapping(value ="upload", consumes = MediaType.MULTIPART_FORM_DATA_VALUE)

consumes直譯是消費(fèi)者，其實(shí)就是限制方法處理指定Content-Type的http請(qǐng)求

常見的媒體格式類型

如下：

text/html：HTML格式
text/plain：純文本格式
text/xml：XML格式
image/gif：gif圖片格式
image/jpeg：jpg圖片格式
image/png：png圖片格式
application/xhtml+xml：XHTML格式
application/xml：XML數(shù)據(jù)格式
application/atom+xml：Atom XML聚合格式
application/json：JSON數(shù)據(jù)格式
application/pdf：pdf格式
application/msword：Word文檔格式
application/octet-stream：二進(jìn)制流數(shù)據(jù)（如常見的文件下載）
application/x-www-form-urlencoded：<form encType=””>中默認(rèn)的encType，form表單數(shù)據(jù)被編碼為key/value格式發(fā)送到服務(wù)器（表單默認(rèn)的提交數(shù)據(jù)的格式）
multipart/form-data：需要在表單中進(jìn)行文件上傳時(shí)，就需要使用該格式