SpringBoot項目 文件上傳臨時目標被刪除異常的處理方案

Posted on by

1、業務背景

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

由於最近此項目業務甲方需要新增部分功能。但是測試在上傳課程時候，需要上傳課程封面，發現上傳課程封面的圖片上傳接口報錯500啦。

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

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

最後我根據錯誤提示搜索一下，結果發現是tomcat的臨時目錄被刪除瞭。最後找到一篇文章說得比較清楚有如下幾點：

(1)、SpringBoot項目啟動後，系統默認會在 /tmp 目錄下自動創建如下三個目錄

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

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

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

/tmp目錄的清理規則主要取決於/usr/lib/tmpfiles.d/tmp.conf文件的設定，默認的配置內容為：

# 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天前的目錄和文件

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

於是就出現瞭文章開始出所說的出現上傳文件的臨時目錄不存在，於是上傳問題報錯500的問題啦。我的同事說瞭一句啟動某個微服務還特定說瞭一句啟動網關服務就可以瞭。

話有說回來，啟動任何一個SpringBoot的微服務都可以實現上傳(因為啟動任何一個本機的微服務將生成對應的臨時目錄)。最後啟動瞭一個微服務，結果確實可以上傳啦。

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

2、三種解決方案

2.1、直接修改CentOS清理臨時目則錄規

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

/tmp目錄的清理規則主要取決於/usr/lib/tmpfiles.d/tmp.conf文件的設定：

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

x /tmp/tomcat.*

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

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

@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的配置之中設定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、成果展現

4、總結

我們在遇見問題瞭，可能僅僅看見表面上問題已經解決瞭。但是作為技術，應該深究是什麼原因導致的。在此也很感謝互聯網，讓很多大神能夠分享自己發現的問題和解決方案。同時也說明瞭其中的原理，這樣有助於從根源解決問題。

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=文件路徑，需要加上該路徑。

創建一個類，裡面包含以下方法：

@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。

換下即可成功。

以上為個人經驗，希望能給大傢一個參考，也希望大傢多多支持WalkonNet。

推薦閱讀：