Spring MVC+REST多文件上传AWS Bucket：如何提示部分文件上传失败

你现在的代码在单个文件上传失败时会直接抛出异常，导致整个上传流程中断，而且没法区分哪些文件成功、哪些失败。要解决这个问题，我们需要为每个文件的上传独立处理异常，收集成功和失败的文件信息，最后把这些清晰的反馈给用户。

下面是具体的修改方案：

1. 修改上传入口方法，收集成功/失败文件列表 #

在handleFileUpload方法里，我们创建两个列表分别记录成功和失败的文件，循环处理每个文件时用try-catch包裹上传逻辑，这样单个文件失败不会影响其他文件的上传：

@PostMapping("/upload")
public String handleFileUpload(@RequestParam("specifications") MultipartFile[] specifications, 
                               HttpServletRequest request, 
                               HttpSession session, 
                               final RedirectAttributes redirectAttributes) {
    // 初始化成功/失败文件列表
    List<String> successfulFiles = new ArrayList<>();
    List<String> failedFiles = new ArrayList<>();

    for (MultipartFile file : specifications) {
        // 先过滤空文件，避免无效上传
        if (file.isEmpty()) {
            failedFiles.add(file.getOriginalFilename() + " (文件为空，无法上传)");
            continue;
        }

        String path = "Specification/";
        String bucketName = "BUcket/";
        String inJson = "{\"filename\":\"" + file.getOriginalFilename() + "\",\"bucketname\":\""+ bucketName + "\",\"path\":\""+ path + "\"}";
        
        try {
            // 尝试上传文件
            addLogo(file, inJson);
            successfulFiles.add(file.getOriginalFilename());
        } catch (IOException e) {
            // 捕获上传异常，记录失败原因
            failedFiles.add(file.getOriginalFilename() + " (错误：" + e.getMessage() + ")");
            // 建议用日志框架替代printStackTrace，方便线上排查问题
            e.printStackTrace();
        }
    }

    // 将结果通过Flash属性传递给前端（重定向后依然能获取）
    if (!successfulFiles.isEmpty()) {
        redirectAttributes.addFlashAttribute("successMsg", "✅ 成功上传的文件：" + String.join(", ", successfulFiles));
    }
    if (!failedFiles.isEmpty()) {
        redirectAttributes.addFlashAttribute("errorMsg", "❌ 上传失败的文件：" + String.join(", ", failedFiles));
    }

    // 跳转到上传结果页面
    return "redirect:/upload-result";
}

2. 优化文件上传工具方法，增强错误判断 #

修改addLogo方法，添加对HTTP响应状态码的检查（比如非200状态码就判定为失败），同时使用try-with-resources自动关闭HTTP客户端和响应，避免资源泄漏：

public void addLogo(MultipartFile file, String inJson) throws IOException {
    byte[] bytes = file.getBytes();
    // 使用try-with-resources自动关闭Closeable资源，避免内存泄漏
    try (CloseableHttpClient httpclient = HttpClientBuilder.create().build()) {
        HttpPost httppost = new HttpPost(fileUploadURL);
        HttpEntity entity = MultipartEntityBuilder.create()
                .addTextBody("json", inJson)
                .addBinaryBody("file", bytes)
                .build();
        httppost.setEntity(entity);

        try (CloseableHttpResponse response = httpclient.execute(httppost)) {
            int statusCode = response.getStatusLine().getStatusCode();
            // 如果服务器返回非200状态码，抛出异常告知调用方
            if (statusCode != HttpStatus.SC_OK) {
                throw new IOException("服务器返回异常状态码：" + statusCode);
            }
            // 可以在这里解析响应内容，做更多业务校验
            ResponseHandler<String> handler = new BasicResponseHandler();
            String responseBody = handler.handleResponse(response);
            System.out.println("文件[" + file.getOriginalFilename() + "]上传响应：" + responseBody);
        }
    }
}

3. 前端页面展示上传结果 #

在你的上传结果页面（比如upload-result.html），通过Spring模板表达式获取传递的消息，直观展示给用户。这里以Thymeleaf为例：

<!DOCTYPE html>
<html xmlns:th="http://www.thymeleaf.org">
<head>
    <title>上传结果</title>
    <style>
        .success { color: green; margin: 10px 0; padding: 8px; border-radius: 4px; background-color: #f0f8f0; }
        .error { color: red; margin: 10px 0; padding: 8px; border-radius: 4px; background-color: #ffeaea; }
    </style>
</head>
<body>
    <h2>文件上传结果</h2>
    <div th:if="${successMsg}" class="success">
        <p th:text="${successMsg}"></p>
    </div>
    <div th:if="${errorMsg}" class="error">
        <p th:text="${errorMsg}"></p>
    </div>
    <a href="/upload">返回上传页面</a>
</body>
</html>

额外优化建议 #

• 日志规范：用SLF4J+Logback等日志框架替代e.printStackTrace()，方便线上排查问题。
• 重试机制：如果是临时网络波动导致的失败，可以添加有限次数的重试逻辑，提升上传成功率。
• 文件大小限制：在Spring配置文件中设置文件上传的大小阈值，避免超大文件引发的异常。

内容的提问来源于stack exchange，提问作者smitha gowda