当前位置：首页 > news >正文

web文件上传

news 2025/9/9 20:35:20

文件上传指的是，将本地的图片、视频、音频上传到服务器，提供给其他用户浏览和下载的过程

前端需求

想要进行文件上传对于web前端来说有三个重要要素

1.<input type="file" name="image"> 提供这样的file文件上传格式
2. method="post" 由于上传文件一般比较大，所以上传格式采用post类型
3. enctype="multipart/form-data" 设置文件编码格式，如果不选这个提交的就是文件名

action="/upload"表示提交的位置

    <form action="/upload" method="post" enctype="multipart/form-data">姓名: <input type="text" name="username"><br>年龄: <input type="text" name="age"><br>头像: <input type="file" name="image"><br><input type="submit" value="提交"></form>

后端代码

HTML中的name应该要与public Result upload（）中的形参名称一一对应，如果没有对应记得进行映射。
MultipartFile img用于图像对象

package com.ztt.controller;import com.ztt.pojo.Result;
import lombok.extern.slf4j.Slf4j;
import org.springframework.web.bind.annotation.PostMapping;
import org.springframework.web.bind.annotation.RestController;
import org.springframework.web.multipart.MultipartFile;@Slf4j
@RestController
public class UploadController {@PostMapping("/upload")public Result upload(String username, Integer age, MultipartFile img){log.info("文件上传:{}{}{}",username,age,img);return Result.success();}
}

本地存储

服务端接收到上传的文件后，将文件保存到本地的磁盘目录上。

@Slf4j
@RestController
public class UploadController {@PostMapping("/upload")public Result upload(String username, Integer age, MultipartFile image) throws Exception{log.info("文件上传:{}{}{}",username,age,image);// 获取文件名称String originalFilename = image.getOriginalFilename();// 将文件存储在本地服务器的磁盘目录下image.transferTo(new File("D:\\images\\"+originalFilename));return Result.success();}
}

注意，本地存储的路径一定要事先准备好，否则会保存

java.io.IOException: java.io.FileNotFoundException: D:\images[3].jpg (系统找不到指定的路径。)

测试的话使用POSTMAN就可以，使用post发送，选择File文件发送即可。
在这里插入图片描述

在springboot中，文件上传单次允许最大为1MB。如果需要进行大文件上传，需要进行配置。

在resources中的application.properties中进行配置。
在这里插入图片描述

# 单个文件上传限制
spring.servlet.multipart.max-file-size=10MB# 单个请求最大限制
spring.servlet.multipart.max-request-size=100MB

保证文件名唯一性

如果存储在同一路径下，可能导致服务器路径重复或名称重复导致文件被覆盖。为解决这个问题，我们一般采用UUID的方法。

String originalFilename = image.getOriginalFilename();
// 将文件存储在本地服务器的磁盘目录下
// 获取文件扩展名
int index = originalFilename.lastIndexOf(".");
String exname = originalFilename.substring(index);String newFileName = UUID.randomUUID() + exname;
// 构造文件唯一性（不能重复） 适应 --uuid（通用唯一识别码）

阿里云OSS

在这里插入图片描述
java引入依赖

<!--阿里云OSS依赖-->
<dependency><groupId>com.aliyun.oss</groupId><artifactId>aliyun-sdk-oss</artifactId><version>3.15.1</version>
</dependency>

java 9 以上的版本还需要引入下面的依赖

<dependency><groupId>javax.xml.bind</groupId><artifactId>jaxb-api</artifactId><version>2.3.1</version>
</dependency>
<dependency><groupId>javax.activation</groupId><artifactId>activation</artifactId><version>1.1.1</version>
</dependency>
<!-- no more than 2.3.3-->
<dependency><groupId>org.glassfish.jaxb</groupId><artifactId>jaxb-runtime</artifactId><version>2.3.3</version>
</dependency>