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

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

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

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

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

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

(1)、SpringBoot項目啟動后，系統(tǒng)默認會在 /tmp 目錄下自動創(chuàng)建如下三個目錄

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

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

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

/tmp目錄的清理規(guī)則主要取決于/usr/lib/tmpfiles.d/tmp.conf文件的設(shè)定，默認的配置內(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ù)以上幾條情況，可以看得出我們上傳文件的臨時目錄，在CentOS7之中，會每10天進行定時清理掉。

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

話有說回來，啟動任何一個SpringBoot的微服務(wù)都可以實現(xiàn)上傳(因為啟動任何一個本機的微服務(wù)將生成對應(yīng)的臨時目錄)。最后啟動了一個微服務(wù)，結(jié)果確實可以上傳啦。

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

2、三種解決方案

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

直接暴力指定不清楚所有臨時目錄，精細化管理針對上傳文件tomcat目錄不進行清除。

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

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

x /tmp/tomcat.*

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

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

@Configuration
public class MultipartConfig { 
    /**
     * 文件上傳臨時路徑
     */
    @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
#指定上傳文件臨時目錄
spring.http.multipart.location=/opt/data/upload

3、成果展現(xiàn)

4、總結(jié)

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

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

一：代碼報錯

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中上傳文件沒有臨時目錄所以會報以上錯誤，需要在application配置文件中指定臨時文件目錄

server.tomcat.basedir=文件路徑

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

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

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

重啟即可生效。

二：代碼報錯

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。

換下即可成功。

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

最新評論