SpringBoot3.4.3实现文件上传和全局异常处理

itbeien2025年3月3日大约 6 分钟

SpringBoot3.4.3实现文件上传和全局异常处理

本专栏前一篇文章SpringBoot3.4.3实现(文本/附件/HTML/图片)类型邮件发送案例。今天分享SpringBoot3.4.3实现文件上传和全局异常处理功能，文件上传功能在有资料录入需求的场景经常用到。

完整代码在文章最后，如果觉得本篇文章对你有用，记得点赞、关注、收藏哦。你的支持是我持续更新的动力!

文章最后可以加入免费的Java&AI技术和支付系统沟通社群，一起探讨Java/你的产品如何与AI结合，请按照要求加入。在群中可以聊开发、系统设计、架构、行业趋势、AI等等话题

SpringBoot3专栏软件环境

JDK17.0.12
SpringBoot3.4.3
IDEA2024.3.3

我们先看本篇文章对应的项目结构，请看下图

1 pom依赖

<?xml version="1.0" encoding="UTF-8"?>
<project xmlns="http://maven.apache.org/POM/4.0.0"
         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
    <modelVersion>4.0.0</modelVersion>
    <parent>
        <groupId>cn.itbeien</groupId>
        <artifactId>springboot3-labs-master</artifactId>
        <version>1.0-SNAPSHOT</version>
    </parent>

    <artifactId>springboot-fileupload</artifactId>

    <dependencies>
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-web</artifactId>
        </dependency>
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-thymeleaf</artifactId>
        </dependency>
        <dependency>
            <groupId>org.projectlombok</groupId>
            <artifactId>lombok</artifactId>
        </dependency>
    </dependencies>

</project>

2 配置信息

spring.servlet.multipart.max-file-size=100MB
spring.servlet.multipart.max-request-size=100MB

3 代码实现

package cn.itbeien.upload.controller;

import lombok.extern.slf4j.Slf4j;
import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.PostMapping;
import org.springframework.web.bind.annotation.RequestParam;
import org.springframework.web.multipart.MultipartFile;
import org.springframework.web.servlet.mvc.support.RedirectAttributes;

import java.io.IOException;
import java.nio.file.Files;
import java.nio.file.Path;
import java.nio.file.Paths;

/**
 * @author itbeien
 * 项目网站：https://www.itbeien.cn
 * 公众号：贝恩聊架构
 * 全网同名，欢迎小伙伴们关注
 * Java/AI学习社群
 * Copyright© 2025 itbeien
 */
@Controller
@Slf4j
public class UploadController {

    // 定义上传文件路径
    private static String UPLOADED_FOLDER = "d://temp//";

    // 返回上传页面
    @GetMapping("/")
    public String index() {
        return "upload";
    }

    // 处理文件上传
    @PostMapping("/upload")
    public String singleFileUpload(@RequestParam("file") MultipartFile file,
        RedirectAttributes redirectAttributes) {
        // 判断文件是否为空
        if (file.isEmpty()) {
            redirectAttributes.addFlashAttribute("message", "请选择需要上传的文件");
            return "redirect:uploadStatus";
        }

        try {
            // 获取文件字节数组
            byte[] bytes = file.getBytes();
            // 获取文件路径
            Path dir = Paths.get(UPLOADED_FOLDER);
            Path path = Paths.get(UPLOADED_FOLDER + file.getOriginalFilename());
            // 判断路径是否存在，不存在则创建
            if(!Files.exists(dir)) {
                Files.createDirectories(dir);
            }
            // 将文件写入路径
            Files.write(path, bytes);
            // 添加上传成功信息
            redirectAttributes.addFlashAttribute("message",
                "你成功上传 '" + file.getOriginalFilename() + "'");

        } catch (IOException e) {
            // 添加上传失败信息
            redirectAttributes.addFlashAttribute("message", "系统异常");
            log.error(e.getMessage());
        }
        // 重定向到上传状态页面
        return "redirect:/uploadStatus";
    }

    // 返回上传状态页面
    @GetMapping("/uploadStatus")
    public String uploadStatus() {
        return "uploadStatus";
    }

}

4 全局异常配置

package cn.itbeien.upload.exception;

import lombok.extern.slf4j.Slf4j;
import org.springframework.web.bind.annotation.ControllerAdvice;
import org.springframework.web.bind.annotation.ExceptionHandler;
import org.springframework.web.multipart.MultipartException;
import org.springframework.web.servlet.mvc.support.RedirectAttributes;

/**
 * @author itbeien
 * 项目网站：https://www.itbeien.cn
 * 公众号：贝恩聊架构
 * 全网同名，欢迎小伙伴们关注
 * Java/AI学习社群
 * Copyright© 2025 itbeien
 */
@ControllerAdvice
@Slf4j
public class GlobalExceptionHandler {

    // 处理MultipartException异常
    @ExceptionHandler(MultipartException.class)
    public String handleError(MultipartException e, RedirectAttributes redirectAttributes) {
        // 记录异常信息
        log.error(e.getMessage());
        // 将异常信息添加到重定向属性中
        redirectAttributes.addFlashAttribute("message", e.getMessage());
        // 重定向到/uploadStatus页面
        return "redirect:/uploadStatus";
    }
}