SpringBoot: 浅谈文件上传和访问的坑 (MultiPartFile)

╰半橙微兮° 2023-01-09 15:51 52阅读 0赞

![09afb847119c8914de23269345baa503.png][]

> **本次的项目环境为 SpringBoot 2.0.4, JDK8.0. 服务器环境为CentOS7.0, Nginx的忘了版本.**

#### 前言 ####

--------------------

SpringBoot使用MultiPartFile接收来自表单的file文件,然后进行服务器的上传是一个项目最基本的需求,我以前的项目都是基于SpringMVC框架搭建的,所以在使用SpringBoot的时候进行MultiPartFile上传遇到了坑,这里说一下,其中主要包含两个坑点.

>  *  使用transferTo()方法写入File时找不到文件路径.
>  *  访问文件时Nginx的403 forbidden问题.

#### 使用transferTo()方法写入File时找不到文件路径 ####

--------------------

在我们解决问题之前,我们先看一下封装的上传方法以及报错日志.

public static final String BASE_PATH = "/test/";
    
        public static String upload(MultipartFile imageFile) {
    
        	if (imageFile.isEmpty()) {
                return null;
            }
            String filename = imageFile.getOriginalFilename();
            
        	String ext= null;
        	if(filename.contains(".")){
        		ext = filename.substring(filename.lastIndexOf("."));
        	}else{
        		ext = "";
        	}
            
            String uuid =  UUID.randomUUID().toString().replaceAll("-", "");
            String nfileName = uuid + ext;
            String dirPath = DateFormatUtils.format(new Date(), "yyyyMMdd");
            String filepath = BASE_PATH.endsWith("/") ? BASE_PATH+dirPath : BASE_PATH+"/"+dirPath;
            File targetFile = new File(filepath, nfileName);
            if (!targetFile.exists()) {
                targetFile.mkdirs();
            } else {
                targetFile.delete();
            }
            try {
                imageFile.transferTo(targetFile);
            } catch (IllegalStateException e) {
                e.printStackTrace();
            } catch (IOException e) {
                e.printStackTrace();
            }
    
            String accessUrl =  "/"+nfileName;
            logger.debug("上传文件成功 URL：" + nfileName);
            return accessUrl;
        }

报错日志如下所示.

java.io.IOException: java.io.FileNotFoundException: /test/20181025/be3676dffca94c6dac5e96a1a41dcd97.jpg (Is a directory)
    	at org.apache.catalina.core.ApplicationPart.write(ApplicationPart.java:122)
    	at org.springframework.web.multipart.support.StandardMultipartHttpServletRequest$StandardMultipartFile.transferTo(StandardMultipartHttpServletRequest.java:255)
    	at com.dong.runline.common.utils.UploadUtils.upload(UploadUtils.java:56)
    	at com.dong.runline.controller.TimeLineController.createTimeLineAction(TimeLineController.java:55)
    	at sun.reflect.NativeMethodAccessorImpl.invoke0(Native Method)
    	at sun.reflect.NativeMethodAccessorImpl.invoke(NativeMethodAccessorImpl.java:62)
    	at sun.reflect.DelegatingMethodAccessorImpl.invoke(DelegatingMethodAccessorImpl.java:43)
    	at java.lang.reflect.Method.invoke(Method.java:498)

![eb9b910b65293a01981755b83ce50498.png][]

这里就出现了**java.io.FileNotFoundException**错误,这是怎么造成的呢?,通过Debug下的断点我们发现是下面的位置发生了错误.

![39afa3f25391608f0040b876aff5df9e.png][]

这里我用的本地环境进行了测试,发现本地创建了这个样的一个路径,最后的图片被创建成一个这样的路径.

![011d5d21969fc94178b6ee0b6ab1b961.png][]

在SpringMVC环境下并没有这样的问题,在SpringBoot却出现了这样的问题,那么到底怎么造成的呢?网上的很多博客写到,通过查询transferTo()方法源码找到了问题关键所在.

@Override
    public void transferTo(File dest) throws IOException, IllegalStateException {
        this.part.write(dest.getPath());
    }

我们接着进入write()方法.

@Override
        public void write(String fileName) throws IOException {
            File file = new File(fileName);
            if (!file.isAbsolute()) {
                file = new File(location, fileName);
            }
            try {
                fileItem.write(file);
            } catch (Exception e) {
                throw new IOException(e);
            }
        }

这时候我们看到如果`!file.isAbsolute()`成立,也就是我们没有使用绝对路径,那么`file = new File(location,fileName);`会在原来的基础上加上location路径.这就是原因所在,解决起来也很方便,网上总共有两种方案.

>  *  使用绝对路径
>  *  修改location的值

第一种方案我们就不过多解释了,我们看一下如何修改location的值.我们只需要在启动类中注入如下Bean即可.把路径指向我们的存储路径.

@Bean
        MultipartConfigElement multipartConfigElement() {
            MultipartConfigFactory factory = new MultipartConfigFactory();
            factory.setLocation(UploadUtils.BASE_PATH);
            return factory.createMultipartConfig();
        }

然后我们再修改下UploadUtils中的创建File方法即可.

![fa0eb74a8e9e20265080206d1ec88238.png][]

String uuid =  UUID.randomUUID().toString().replaceAll("-", "");
            String nfileName = uuid + ext;
            File targetFile = new File(nfileName);
            if (!targetFile.exists()) {
                targetFile.mkdirs();
            } else {
                targetFile.delete();
            }

#### 访问文件时Nginx的403 forbidden问题 ####

--------------------

所谓的Nginx的403错误其实就是访问权限错误.当前用户没有访问该资源的权限,这样理解的话,我们就有两种方案可行.一,**降低文件访问的权限等级**.二,**升高用户的访问权限**.下面我们一个一个来看一下如何进行实现.

>  *  **降低文件访问的权限等级**

降低文件的访问权限,我们只需要用到 **chmod**指令即可.这里简单解释一下**chmod**指令.

在Mac的使用过程中我们也经常会修改 某个文件的权限,例如:

chmod 777 file

如果如上设置的话,那么任何一个用户都会对这个file文件拥有全部权限.

那么为什么是三位数呢?这是因为这三位数分别代表着档案拥有者User、群组Group、其他Other三者的权限.也就是说拥有者的权限等级为7,群组的权限等级为7,其他权限等级也为7.

那么为什么是7呢?这是因为一个linux文件总共有三种权限,分别是读r,写w,操作x.对应的值分别是4,2,1.当一个用户对某个文件拥有7的数值时,这时候为4+2+1,也就是说他拥有该文件全部的权限.

上面说了 **chmod**指令的如何使用,那么接下来我们就可以对服务器的文件使用**chmod 664 file**指令,然后降低文件访问的权限等级.使全部用户都拥有文件的访问权限.但是问题来了,难道用户上传一次,我们就需要手动修改一次文件的权限,这显然是不正确的,那么我们该怎么办呢?这时候我们就需要提高用户的访问权限了.

>  *  **升高用户的访问权限**

提高用户的访问权限,这里其实是修改Nginx的启动者,我们把启动者设置为最多权限者,那么我们就可以访问到文件了.

首先我们先看是谁启动了Nginx需要用到如下的指令.

ps aux | grep "nginx: worker process" | awk '{print $1}'

这里我已经做了修改,截图如下所示.

![eaa52c4999e573c4929c9f263e15599f.png][]

本来要是不对Nginx的配置进行任何设置访问的话,那么第一个root应该为nobody,也就是Nginx的启动者.先前已经使用\*\* ls -l file \*\*指令查询了文件的权限情况,root 拥有读写权限,other没有任何权限.所以我们要把启动者改为root即可.

打开Nginx配置文件所在的位置,\{nginx\}表示你的nginx安装路径.

vi {nginx}/conf/nginx.conf

添加启动者,如下所示.

user root

返回到sbin目录中,准备检测配置文件和重新启动Ngnix.

cd ../sbin/

检测配置文件的正确性

./nginx -t

![9e103b1270ef3d668871650c6e9c34fd.png][]

检测没有任何问题,重新启动

./nginx -s reload

这时候即可正常访问到文件了.

#### 结语 ####

--------------------

这篇博客算是日常的问题收集吧,整理一下.没什么可多说的,就是搞事.欢迎关注骚栋

![1cc773b3510614b54c92ffc3dc40d24a.gif][]

[09afb847119c8914de23269345baa503.png]: /images/20221119/6d17068a9e3c43dfbbb4d676c32630a8.png
[eb9b910b65293a01981755b83ce50498.png]: https://img-blog.csdnimg.cn/img_convert/eb9b910b65293a01981755b83ce50498.png
[39afa3f25391608f0040b876aff5df9e.png]: https://img-blog.csdnimg.cn/img_convert/39afa3f25391608f0040b876aff5df9e.png
[011d5d21969fc94178b6ee0b6ab1b961.png]: https://img-blog.csdnimg.cn/img_convert/011d5d21969fc94178b6ee0b6ab1b961.png
[fa0eb74a8e9e20265080206d1ec88238.png]: https://img-blog.csdnimg.cn/img_convert/fa0eb74a8e9e20265080206d1ec88238.png
[eaa52c4999e573c4929c9f263e15599f.png]: https://img-blog.csdnimg.cn/img_convert/eaa52c4999e573c4929c9f263e15599f.png
[9e103b1270ef3d668871650c6e9c34fd.png]: https://img-blog.csdnimg.cn/img_convert/9e103b1270ef3d668871650c6e9c34fd.png
[1cc773b3510614b54c92ffc3dc40d24a.gif]: https://img-blog.csdnimg.cn/img_convert/1cc773b3510614b54c92ffc3dc40d24a.gif