SpringBoot异步处理Excel：用CompletableFuture收集失败记录

开发者阿泽

2026-6-30

解决方案

1. 在控制器中处理异步任务的完成回调

你已经通过importService.processExcelFile(worksheet)获取到了CompletableFuture<List<String>>，只需为这个Future添加完成回调，就能在异步任务结束后拿到合并后的错误列表，进而触发邮件发送逻辑：

CompletableFuture<List<String>> completableFutureErrorsList = importService.processExcelFile(worksheet);

// 添加异步完成回调
completableFutureErrorsList.whenComplete((errorsList, exception) -> {
    if (exception != null) {
        // 处理异步任务执行过程中出现的全局异常
        logger.error("Excel文件处理任务执行异常", exception);
        return;
    }
    
    // 错误列表非空时，调用邮件服务发送
    if (!errorsList.isEmpty()) {
        // 替换为你的邮件发送逻辑
        emailService.sendImportErrorEmail(errorsList);
    }
});

2. 修正服务层无效代码

你的processExcelRow方法中，CompletableFuture.failedFuture(new Exception("Missing Name"));这行代码是无效的——它创建了一个失败的Future但没有被任何逻辑处理，完全可以删除，因为你已经将错误信息添加到了errorsList中，后续会通过返回的Future统一获取。修正后的方法：

public void processExcelRow(XSSFRow row, List<String> errorsList) {
    XSSFCell cell = row.getCell(0, Row.MissingCellPolicy.RETURN_BLANK_AS_NULL);
    if (cell == null) {
        errorsList.add("Missing Name");
        // 移除无效的failedFuture调用
    } else {
        // 正常行处理逻辑
    }
}