如何在JSF中通过PrimeFaces FileUpload禁止重复文件上传？

当然有靠谱的实现方案！结合PrimeFaces和JSF的特性，我们可以从前端体验优化和后端安全校验两个层面入手，既让用户及时得到反馈，又能彻底杜绝重复文件的上传——毕竟前端校验只是锦上添花，后端才是真正的安全屏障。

PrimeFaces的<p:fileUpload>组件支持客户端事件和远程命令，我们可以在文件上传发起前，先异步检查目标文件名是否已存在，避免用户白等上传过程。

举个完整的实现示例：

<!-- 远程命令：用于触发后端的文件名重复检查 -->
<p:remoteCommand name="checkDuplicateFile" 
                 action="#{fileUploadBean.checkFileNameExists}" 
                 oncomplete="handleCheckResult(xhr, status, args)" />

<!-- 文件上传组件：开启高级模式，绑定前置校验事件 -->
<p:fileUpload id="fileUpload" mode="advanced"
              onstart="return validateFileName(this.files[0].name);"
              fileUploadListener="#{fileUploadBean.handleFileUpload}"
              allowTypes="/(\.|\/)(gif|jpe?g|png|pdf)$/" />

<!-- 辅助组件：加载提示和消息通知 -->
<p:dialog widgetVar="statusDialog" modal="true" draggable="false" closable="false">
    <p:graphicImage name="/images/loading.gif" />
</p:dialog>
<p:growl widgetVar="growl" />

<script>
// 前置校验：阻止默认上传，先调用后端检查
function validateFileName(fileName) {
    checkDuplicateFile([{name: 'fileName', value: fileName}]);
    PF('statusDialog').show();
    // 先返回false阻止上传，等校验结果回来再决定是否触发上传
    return false;
}

// 处理后端校验结果
function handleCheckResult(xhr, status, args) {
    PF('statusDialog').hide();
    if (args.isDuplicate) {
        PF('growl').show([{severity: 'warn', summary: '提示', detail: `文件 ${args.fileName} 已存在，请更换文件名或选择其他文件`}]);
    } else {
        // 校验通过，手动触发上传
        PF('fileUpload').upload();
    }
}
</script>

对应的后端Bean代码：

@ManagedBean
@ViewScoped
public class FileUploadBean implements Serializable {

    // 替换成你实际的文件存储目录
    private final String UPLOAD_DIR = "/opt/webapp/uploads";

    // 处理前端的文件名重复检查请求
    public void checkFileNameExists() {
        FacesContext context = FacesContext.getCurrentInstance();
        String fileName = context.getExternalContext().getRequestParameterMap().get("fileName");
        File targetFile = new File(UPLOAD_DIR, fileName);
        
        // 把校验结果返回给前端
        boolean isDuplicate = targetFile.exists();
        PrimeFaces.current().ajax().addCallbackParam("isDuplicate", isDuplicate);
        PrimeFaces.current().ajax().addCallbackParam("fileName", fileName);
    }

    // 文件上传核心处理方法
    public void handleFileUpload(FileUploadEvent event) {
        UploadedFile uploadedFile = event.getFile();
        File targetFile = new File(UPLOAD_DIR, uploadedFile.getFileName());
        
        // 这里必须再做一次校验！防止用户绕过前端JS
        if (targetFile.exists()) {
            FacesContext.getCurrentInstance().addMessage(null, 
                new FacesMessage(FacesMessage.SEVERITY_WARN, "提示", "文件已存在"));
            return;
        }

        // 执行文件保存逻辑（可以用Apache Commons IO简化流操作）
        try (InputStream is = uploadedFile.getInputstream();
             OutputStream os = new FileOutputStream(targetFile)) {
            IOUtils.copy(is, os);
            FacesContext.getCurrentInstance().addMessage(null, 
                new FacesMessage(FacesMessage.SEVERITY_INFO, "成功", "文件上传完成"));
        } catch (IOException e) {
            FacesContext.getCurrentInstance().addMessage(null, 
                new FacesMessage(FacesMessage.SEVERITY_ERROR, "错误", "文件上传失败"));
            e.printStackTrace();
        }
    }
}

不管前端有没有做校验，后端在处理文件上传时的重复检查是必不可少的——毕竟用户可以通过浏览器调试工具轻易绕过前端逻辑。

如果你的项目会把文件信息记录到数据库（比如存储文件名、路径、上传人等），还要同时校验数据库中的记录：

@Inject
private FileRecordRepository fileRecordRepo;

public void handleFileUpload(FileUploadEvent event) {
    UploadedFile uploadedFile = event.getFile();
    String fileName = uploadedFile.getFileName();
    
    // 1. 检查磁盘中是否存在同名文件
    File targetFile = new File(UPLOAD_DIR, fileName);
    // 2. 检查数据库中是否存在同目录下的同名文件记录
    boolean existsInDb = fileRecordRepo.existsByFileNameAndUploadDir(fileName, UPLOAD_DIR);

    if (targetFile.exists() || existsInDb) {
        FacesContext.getCurrentInstance().addMessage(null, 
            new FacesMessage(FacesMessage.SEVERITY_WARN, "提示", "文件 " + fileName + " 已存在"));
        return;
    }

    // 保存文件到磁盘 + 记录到数据库
    // ... 省略具体逻辑
}

如果不想让用户手动更换文件名，可以实现自动重命名逻辑，比如在文件名后添加(1)、(2)后缀，直到找到唯一的文件名：

private File getUniqueTargetFile(String dir, String fileName) {
    File targetFile = new File(dir, fileName);
    if (!targetFile.exists()) {
        return targetFile;
    }

    // 拆分文件名和后缀
    String baseName = FilenameUtils.getBaseName(fileName);
    String extension = FilenameUtils.getExtension(fileName);
    int counter = 1;

    while (true) {
        String newFileName = baseName + "(" + counter + ")." + extension;
        targetFile = new File(dir, newFileName);
        if (!targetFile.exists()) {
            return targetFile;
        }
        counter++;
    }
}

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