PrimeFaces 3.4.2多次单文件上传：后续文件监听器未触发问题排查

我来帮你分析下PrimeFaces 3.4.2里这种单文件多次上传只有第一个触发监听器的问题，大概率是这几个原因导致的：

• 组件状态未重置
  PrimeFaces 3.x的单文件上传组件在完成一次上传后，默认不会自动重置自身状态。如果不手动清理，后续选择文件上传时，组件可能还保留着之前的请求痕迹，导致服务器端忽略后续的上传请求。
  解决办法：可以在上传完成后，通过前端JS重置表单，比如在上传成功的回调里执行：

  document.getElementById('uploadFileForm').reset();
  // 或者用PrimeFaces的widget方法（3.4.2直接调用widgetVar）
  uploadFileWidget.clear();
  

  也可以在后端监听器方法里，触发表单的局部更新来重置状态。

• JSF视图状态不匹配
  JSF依赖视图状态（ViewState）来验证请求的合法性。如果第一次上传后，表单的视图状态没有更新，后续的上传请求会因为视图状态过期或不匹配被服务器拒绝处理，看起来就像监听器没被调用。
  解决办法：给<p:fileUpload>添加update="uploadFileForm"属性，让每次上传完成后自动更新整个表单，刷新视图状态：

  <p:fileUpload id="fileUpload" 
                fileUploadListener="#{yourBean.handleFileUpload}" 
                mode="advanced" 
                auto="true"
                update="uploadFileForm" />
  

• PrimeFaces 3.4.2的版本bug
  3.4.2这个版本确实存在一些文件上传相关的已知bug，其中就包括单文件上传组件多次上传时监听器失效的问题。同系列的3.5版本修复了不少这类问题，如果你能升级到3.5，大概率能直接解决这个问题。

• 文件上传过滤器配置错误
  检查你的web.xml里是否正确配置了PrimeFaces的文件上传过滤器，并且过滤器的顺序是否正确。如果过滤器没有拦截到后续的多部分请求，服务器就无法解析上传的文件，自然不会触发监听器。正确的配置应该是这样的：

  <filter>
      <filter-name>PrimeFaces FileUpload Filter</filter-name>
      <filter-class>org.primefaces.webapp.filter.FileUploadFilter</filter-class>
  </filter>
  <filter-mapping>
      <filter-name>PrimeFaces FileUpload Filter</filter-name>
      <servlet-name>Faces Servlet</servlet-name>
  </filter-mapping>
  

  确保这个过滤器在其他自定义过滤器之前，避免被拦截。

• 监听器方法隐藏异常
  有时候不是监听器没被调用，而是后续上传时方法抛出了异常，但你没有捕获处理，导致请求失败。可以在监听器方法里添加日志输出，或者捕获所有异常并打印，排查是否有文件重名、权限不足等问题：

  public void handleFileUpload(FileUploadEvent event) {
      try {
          UploadedFile file = event.getFile();
          // 你的文件处理逻辑
          System.out.println("处理文件：" + file.getFileName());
      } catch (Exception e) {
          e.printStackTrace();
          // 可以添加前端提示
          FacesContext.getCurrentInstance().addMessage(null, new FacesMessage(FacesMessage.SEVERITY_ERROR, "上传失败", e.getMessage()));
      }
  }
  

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