Spring Boot集成ZK Framework文件上传功能异常求助

针对你提供的ZK文件上传实现，以下是关键问题排查和修复建议：

核心问题分析与修复 #

1. 多文件上传时的无效文件处理逻辑错误 #

原代码中遇到无效文件类型直接return，会终止整个上传流程，导致后续有效文件无法处理。应改为跳过无效文件并继续处理其他文件：

// 替换原无效文件判断逻辑
if (!filename.endsWith(".txt") && !filename.endsWith(".xls") && !filename.endsWith(".csv")) {
    Clients.showNotification("Invalid file type: " + filename, "error", null, "middle_center", 3000);
    continue; // 跳过当前无效文件，继续处理下一个
}

2. 同名文件覆盖风险 #

直接使用原文件名保存会导致同名文件被覆盖，建议添加时间戳或随机后缀避免冲突：

// 替换文件路径生成逻辑
String uniqueFileName = System.currentTimeMillis() + "_" + m.getName();
Path filePath = uploadPath.resolve(uniqueFileName);

3. 多文件上传时的文件名显示问题 #

原代码仅保存最后一个上传的文件名到fileName属性，若支持多文件，建议改用列表存储并更新视图：

// 在VM中添加列表属性
private List<String> uploadedFileNames = new ArrayList<>();

// 替换原fileName赋值逻辑
uploadedFileNames.add(uniqueFileName);
// 更新通知改为列表属性
@NotifyChange("uploadedFileNames")

对应ZUL中修改为列表展示：

<listbox model="@bind(vm.uploadedFileNames)" sclass="form-control col-sm-5">
    <template name="model">
        <listitem label="@load(each)"/>
    </template>
</listbox>

4. 支持多文件上传配置 #

若需要支持多文件上传，需在ZUL按钮中添加multiple=true：

<button id="btn" iconSclass="fa fa-upload" sclass="btn btn-primary"
        label="Upload File" upload="true,multiple=true" 
        onUpload="@command('handleFileUpload', event=event)"/>

5. 文件存储路径权限与规范 #

避免使用项目根目录的相对路径，建议使用系统临时目录或Spring配置的可写目录：

// 使用系统临时目录
Path uploadPath = Paths.get(System.getProperty("java.io.tmpdir"), "zk_uploads");
// 或使用Spring配置的路径（需在application.properties中配置upload.dir=/path/to/uploads）
@Value("${upload.dir}")
private String uploadDir;
// 初始化时使用
Path uploadPath = Paths.get(uploadDir);

6. 流资源安全处理 #

确保文件流正确关闭，使用try-with-resources包裹流操作：

try (InputStream inputStream = m.getStreamData()) {
    Files.copy(inputStream, filePath, StandardCopyOption.REPLACE_EXISTING);
} catch (IOException ex) {
    Clients.showNotification("Error uploading file: " + ex.getMessage(), "error", null, "middle_center", 3000);
}

修复后的完整控制器代码 #

@Command
@NotifyChange("uploadedFileNames")
public void handleFileUpload(@BindingParam("event") UploadEvent event) {
    if (event.getMedias() != null && !event.getMedias().isEmpty()) {
        StringBuilder sb = new StringBuilder("Successfully uploaded: \n");
        Path uploadPath = Paths.get(System.getProperty("java.io.tmpdir"), "zk_uploads");

        if (!Files.exists(uploadPath)) {
            try {
                Files.createDirectories(uploadPath);
            } catch (IOException ex) {
                Clients.showNotification("Failed to create upload directory: " + ex.getMessage(), "error", null, "middle_center", 3000);
                return;
            }
        }

        for (Media m : event.getMedias()) {
            String filename = m.getName().toLowerCase();
            Clients.showNotification("Processing file: " + filename, "info", null, "middle_center", 3000);

            if (!filename.endsWith(".txt") && !filename.endsWith(".xls") && !filename.endsWith(".csv")) {
                Clients.showNotification("Invalid file type: " + filename, "error", null, "middle_center", 3000);
                continue;
            }

            try {
                String uniqueFileName = System.currentTimeMillis() + "_" + m.getName();
                Path filePath = uploadPath.resolve(uniqueFileName);
                try (InputStream inputStream = m.getStreamData()) {
                    Files.copy(inputStream, filePath, StandardCopyOption.REPLACE_EXISTING);
                }
                uploadedFileNames.add(uniqueFileName);
                sb.append(uniqueFileName).append("\n");
                Clients.showNotification("File saved to: " + filePath.toString(), "info", null, "middle_center", 3000);
            } catch (IOException ex) {
                Clients.showNotification("Error uploading file: " + ex.getMessage(), "error", null, "middle_center", 3000);
            }
        }

        Clients.showNotification(sb.toString(), "info", null, "middle_center", 3000);
    } else {
        Clients.showNotification("No files selected for upload!", "warning", null, "middle_center", 3000);
    }
}

修复后的ZUL代码 #

<button id="btn" iconSclass="fa fa-upload" sclass="btn btn-primary"
        label="Upload File" upload="true,multiple=true" 
        onUpload="@command('handleFileUpload', event=event)"/>

<listbox model="@bind(vm.uploadedFileNames)" sclass="form-control col-sm-5"
         placeholder="Uploaded Files" emptyMessage="No files uploaded yet">
    <template name="model">
        <listitem label="@load(each)"/>
    </template>
</listbox>

内容的提问来源于stack exchange，提问作者Vasileios Maziotis