Spring Boot中MultipartFile的transferTo方法失效如何解决？

常见原因及修复方案 #

1. 移除提前创建文件的代码 #

transferTo()方法本身会自动创建目标文件（若不存在），提前调用createNewFile()可能引发权限冲突或覆盖逻辑异常。直接删除文件创建代码，让transferTo()自行处理：

@PostMapping("/form3")
public String handleFormUpload3(@RequestParam("file") MultipartFile file) throws IOException {
    String fileName = file.getOriginalFilename();
    File file1 = new File(fileName);
    // 删除createNewFile()相关代码
    file.transferTo(file1);
    // 验证文件是否有内容（而非仅存在）
    System.out.println(file1.exists() && file1.length() > 0); 
    return "redirect:uploadSuccess";
}

2. 使用明确的绝对路径 #

仅用文件名会默认写入项目启动的工作目录，可能存在权限不足或路径不明确问题。建议指定固定的上传目录（比如项目根目录下的upload文件夹）：

@PostMapping("/form3")
public String handleFormUpload3(@RequestParam("file") MultipartFile file) throws IOException {
    // 定义上传目录并确保存在
    String uploadDir = System.getProperty("user.dir") + "/upload";
    File dir = new File(uploadDir);
    if (!dir.exists()) {
        dir.mkdirs();
    }
    String fileName = file.getOriginalFilename();
    File file1 = new File(uploadDir, fileName);
    file.transferTo(file1);
    System.out.println(file1.exists() && file1.length() > 0);
    return "redirect:uploadSuccess";
}

3. 检查目录写入权限 #

若目标目录无写入权限，transferTo()可能静默失败：

• Linux/macOS：执行chmod 755 [目标目录路径]赋予读写权限
• Windows：右键目标目录→属性→安全面板，为运行应用的用户添加写入权限

4. 配置Spring Multipart参数（针对大文件） #

大文件上传可能触发Spring的默认限制，导致transferTo()失效。在application.properties中添加以下配置：

# 设置单个文件最大大小
spring.servlet.multipart.max-file-size=10MB
# 设置请求总大小上限
spring.servlet.multipart.max-request-size=10MB
# 超过该阈值的文件会写入磁盘临时文件
spring.servlet.multipart.file-size-threshold=2KB

调试建议 #

若问题仍存在，捕获异常并打印堆栈信息定位具体错误：

@PostMapping("/form3")
public String handleFormUpload3(@RequestParam("file") MultipartFile file) {
    try {
        String uploadDir = System.getProperty("user.dir") + "/upload";
        File dir = new File(uploadDir);
        if (!dir.exists()) {
            dir.mkdirs();
        }
        String fileName = file.getOriginalFilename();
        File file1 = new File(uploadDir, fileName);
        file.transferTo(file1);
        System.out.println("文件大小：" + file1.length() + "字节");
        return "redirect:uploadSuccess";
    } catch (IOException e) {
        e.printStackTrace();
        return "redirect:uploadFailure";
    }
}

内容的提问来源于stack exchange，提问作者Gautham Muralidharan