1、業(yè)務(wù)背景

我們使用了SpringCloud 進(jìn)行項(xiàng)目開發(fā)，其中一個(gè)主要服務(wù)(涉及到圖片上傳)的SpringBoot微服務(wù)在測(cè)試環(huán)境之中。因?yàn)榇隧?xiàng)目已經(jīng)上線，很長(zhǎng)一段時(shí)未針對(duì)此項(xiàng)目間做相關(guān)布更改和打包發(fā)。

由于最近此項(xiàng)目業(yè)務(wù)甲方需要新增部分功能。但是測(cè)試在上傳課程時(shí)候，需要上傳課程封面，發(fā)現(xiàn)上傳課程封面的圖片上傳接口報(bào)錯(cuò)500啦。

本人在后端日志目錄之中也無(wú)法查找到報(bào)錯(cuò)信息。僅僅只有前后端分離的前端調(diào)用接口的時(shí)候返回一個(gè)如下錯(cuò)誤提示

Could not parse multipart servlet request;
nested exception is java.io.IOException:
The temporary upload location [/tmp/tomcat/ocalhost/ROOT] is not valid

最后我根據(jù)錯(cuò)誤提示搜索一下，結(jié)果發(fā)現(xiàn)是tomcat的臨時(shí)目錄被刪除了。最后找到一篇文章說(shuō)得比較清楚有如下幾點(diǎn)：

(1)、SpringBoot項(xiàng)目啟動(dòng)后，系統(tǒng)默認(rèn)會(huì)在 /tmp 目錄下自動(dòng)創(chuàng)建如下三個(gè)目錄

• hsperfdata_root，
• tomcat.************.8080,(結(jié)尾是項(xiàng)目的端后)
• tomcat-docbase.*********.8080

(2)、Multipart（form-data）的方式處理請(qǐng)求時(shí)，默認(rèn)就是在第二個(gè)目錄下創(chuàng)建臨時(shí)文件的

(3)、CentOS7 定時(shí)清理臨時(shí)文件目錄

/tmp目錄的清理規(guī)則主要取決于/usr/lib/tmpfiles.d/tmp.conf文件的設(shè)定，默認(rèn)的配置內(nèi)容為：

# Clear tmp directories separately, to make them easier to override
v /tmp 1777 root root 10d           #   清理/tmp下10天前的目錄和文件
v /var/tmp 1777 root root 30d       #   清理/var/tmp下30天前的目錄和文件

依據(jù)以上幾條情況，可以看得出我們上傳文件的臨時(shí)目錄，在CentOS7之中，會(huì)每10天進(jìn)行定時(shí)清理掉。

于是就出現(xiàn)了文章開始出所說(shuō)的出現(xiàn)上傳文件的臨時(shí)目錄不存在，于是上傳問題報(bào)錯(cuò)500的問題啦。我的同事說(shuō)了一句啟動(dòng)某個(gè)微服務(wù)還特定說(shuō)了一句啟動(dòng)網(wǎng)關(guān)服務(wù)就可以了。

話有說(shuō)回來(lái)，啟動(dòng)任何一個(gè)SpringBoot的微服務(wù)都可以實(shí)現(xiàn)上傳(因?yàn)閱?dòng)任何一個(gè)本機(jī)的微服務(wù)將生成對(duì)應(yīng)的臨時(shí)目錄)。最后啟動(dòng)了一個(gè)微服務(wù)，結(jié)果確實(shí)可以上傳啦。

我不希望只要問題解決了就，淺嘗輒止的解決問題就了事啦。最后根據(jù)搜索到的文章和分析，個(gè)人認(rèn)為有如下三種解決方案。

2、三種解決方案

2.1、直接修改CentOS清理臨時(shí)目則錄規(guī)

直接暴力指定不清楚所有臨時(shí)目錄，精細(xì)化管理針對(duì)上傳文件tomcat目錄不進(jìn)行清除。

/tmp目錄的清理規(guī)則主要取決于/usr/lib/tmpfiles.d/tmp.conf文件的設(shè)定：

我們可以配置這個(gè)文件，比如你不想讓系統(tǒng)自動(dòng)清理/tmp下以tomcat開頭的目錄，那么增加下面這條內(nèi)容到配置文件中即可：

x /tmp/tomcat.*

2.2、通過(guò)SpringBoot啟動(dòng)配置注解(@Configuration) 指定自有上傳文件目錄

改變臨時(shí)文件的存儲(chǔ)路徑，指定自定義非CentOS7的系統(tǒng)默認(rèn)臨時(shí)目錄，這樣就可以避免系統(tǒng)在定時(shí)清除臨時(shí)目錄的情況。實(shí)現(xiàn)代碼如下

@Configuration
public class MultipartConfig { 
    /**
     * 文件上傳臨時(shí)路徑
     */
    @Bean
    MultipartConfigElement multipartConfigElement() {
        MultipartConfigFactory factory = new MultipartConfigFactory();
        String location = System.getProperty("user.dir") + "/data/upload/tmp";
        File tmpFile = new File(location);
        if (!tmpFile.exists()) {
            tmpFile.mkdirs();
        }
        factory.setLocation(location);
        return factory.createMultipartConfig();
    }
}

2.3、原理類似第二種方案，但是在SpringBoot的配置之中設(shè)定Profile信息

在propertites/yaml文件中配置： spring.http.multipart.location= 你的緩存文件路徑

spring.mvc.static-path-pattern=/upload/**
spring.http.multipart.max-file-size=10MB
#指定上傳文件臨時(shí)目錄
spring.http.multipart.location=/opt/data/upload

3、成果展現(xiàn)

4、總結(jié)

我們?cè)谟鲆妴栴}了，可能僅僅看見表面上問題已經(jīng)解決了。但是作為技術(shù)，應(yīng)該深究是什么原因?qū)е碌?。在此也很感謝互聯(lián)網(wǎng)，讓很多大神能夠分享自己發(fā)現(xiàn)的問題和解決方案。同時(shí)也說(shuō)明了其中的原理，這樣有助于從根源解決問題。

SpringBoot文件上傳遇到的問題及解決

一：代碼報(bào)錯(cuò)

Could not parse multipart servlet request; nested exception is java.io.IOException: The temporary upload location [D:\\xyqbtest\\work\\Tomcat\\localhost\\xyqb\\nfs\\marvels-core-v2] is not valid

解決方案：

在springboot中上傳文件沒有臨時(shí)目錄所以會(huì)報(bào)以上錯(cuò)誤，需要在application配置文件中指定臨時(shí)文件目錄

server.tomcat.basedir=文件路徑

如果配置了spring.http.multipart.location=文件路徑，需要加上該路徑。

創(chuàng)建一個(gè)類，里面包含以下方法：

@Bean
public MultipartConfigElement multipartConfigElement() {
    MultipartConfigFactory factory = new MultipartConfigFactory();
    factory.setLocation("./tmp");
    return factory.createMultipartConfig();
}

重啟即可生效。

二：代碼報(bào)錯(cuò)

Failed to convert value of type 'org.springframework.web.multipart.support.StandardMultipartHttpServletRequest$StandardMultipartFile' to required type 'org.springframework.web.multipart.commons.CommonsMultipartFile'; nested exception is java.lang.IllegalStateException: Cannot convert value of type 'org.springframework.web.multipart.support.StandardMultipartHttpServletRequest$StandardMultipartFile' to required type 'org.springframework.web.multipart.commons.CommonsMultipartFile': no matching editors or conversion strategy found

解決方案：

在springmvc中接收文件使用的是CommonsMultipartFile，springboot使用的是MultipartFile。

換下即可成功。

以上為個(gè)人經(jīng)驗(yàn)，希望能給大家一個(gè)參考，也希望大家多多支持腳本之家。

最新評(píng)論