Spring Boot报错：MultipartFile资源无法解析为绝对路径，下载失败排查

错误根源 #

1. MockMultipartFile的误用：你在convertFileFromPath中用MockMultipartFile包装本地文件，这个类是为模拟上传场景设计的内存对象，不关联真实文件系统路径。当Spring MVC尝试处理返回的MultipartFile时，会调用其getAbsolutePath()方法，而MockMultipartFile没有真实路径，直接抛出报错。
2. 下载接口设计错误：MultipartFile是接收上传文件的专用类型，不适合作为下载返回的载体。下载应该直接返回文件流给前端，而非封装到DTO中。

修复步骤 #

1. 修改下载接口返回类型 #

将Controller的downloadById方法改为返回文件流，而非包含MultipartFile的DTO：

@GetMapping(value = "/download/{id}")
public ResponseEntity<Resource> downloadById(@PathVariable Long id) throws IOException {
    return service.downloadFileById(id);
}

2. 重写Service层下载逻辑 #

移除convertFileFromPath方法，改用FileSystemResource直接读取本地文件并返回：

@Override
public ResponseEntity<Resource> downloadFileById(Long id) throws IOException {
    // 查询附件信息，不存在则抛异常
    Attachments attachment = repository.findById(id)
            .orElseThrow(() -> new RuntimeException("指定附件不存在"));
    
    // 构建文件路径
    Path filePath = Paths.get(attachment.getPath());
    Resource resource = new FileSystemResource(filePath);

    // 设置响应头，触发浏览器下载
    return ResponseEntity.ok()
            .contentType(MediaType.APPLICATION_OCTET_STREAM)
            .header(HttpHeaders.CONTENT_DISPOSITION, "attachment; filename=\"" + attachment.getName() + "\"")
            .body(resource);
}

3. 优化文件路径存储逻辑 #

在saveAttachment中，替换手动拼接路径的方式，用Path.resolve()保证路径拼接的安全性：

// 替换原来的路径拼接代码
responseDto.setFilePath(root.resolve(fileName).toString());

额外说明 #

• 不需要将本地文件转换为MultipartFile返回，FileSystemResource可以直接被Spring MVC处理为文件流返回给前端。
• 响应头中的Content-Disposition设置为attachment，可以让浏览器识别为下载文件，自动弹出保存对话框。

内容的提问来源于stack exchange，提问作者Eldiyar Amanturov