Primefaces FileUpload在Linux服务器失效，Windows服务器正常

针对Windows部署正常、Linux Tomcat8.5下PrimeFaces文件上传无响应的问题，按以下步骤排查：

• 检查PrimeFaces文件上传依赖库
  确认项目WEB-INF/lib或Tomcat全局lib目录下存在commons-fileupload.jar和commons-io.jar，且版本与PrimeFaces兼容。Linux下若缺失依赖，会导致上传逻辑静默失败。

• 验证Tomcat临时目录权限
  检查Tomcat的临时目录（默认CATALINA_BASE/temp）是否具备读写权限。文件上传时会先将文件写入临时目录，权限不足会导致操作失败且无前台提示。可通过命令ls -ld <temp目录路径>查看权限，必要时用chmod调整。

• 检查Tomcat及项目的文件大小限制配置

  • 查看Tomcatserver.xml中Connector节点的maxPostSize属性，确保其值大于页面设置的sizeLimit（1GB），或设为-1表示无限制；
  • 检查项目web.xml中是否配置了multipart-config，确认maxFileSize、maxRequestSize参数符合需求，示例配置：

    <servlet>
        <servlet-name>Faces Servlet</servlet-name>
        <servlet-class>javax.faces.webapp.FacesServlet</servlet-class>
        <multipart-config>
            <max-file-size>1073741824</max-file-size> <!-- 1GB -->
            <max-request-size>1073741824</max-request-size>
            <file-size-threshold>0</file-size-threshold>
        </multipart-config>
    </servlet>
    

• 确认PrimeFaces文件上传过滤器配置
  检查项目web.xml是否正确配置了PrimeFaces文件上传过滤器，且映射到Faces Servlet，配置示例：

  <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>
  

  注意过滤器顺序需在其他可能拦截请求的过滤器之前。

• 检查前端资源加载与大小写问题
  打开浏览器开发者工具的Network面板，确认primefaces.js等PrimeFaces核心资源已成功加载（无404或500错误）。Linux系统路径大小写敏感，若页面资源引用存在大小写错误（如PrimeFaces.js而非primefaces.js），会导致上传逻辑无法触发。

• 排查后台Bean的文件路径问题
  检查imageFileBean.handleUploadImage方法中是否存在硬编码的Windows路径（如C:\uploads），或使用了Windows专属的反斜杠\。应替换为系统无关的写法，比如用File.separator或正斜杠/，同时确保目标上传目录在Linux下具备读写权限。

• 查看Tomcat后台日志
  不要仅依赖浏览器控制台，检查Tomcat的catalina.out、localhost.log等日志文件，是否存在文件写入失败、权限不足等后台异常信息。部分异常不会反馈到前端，但会记录在服务器日志中。

• 验证文件类型正则的大小写匹配
  页面中allowTypes的正则为/(.|/)(gif|jpe?g|png)$/，Linux下文件名大小写敏感，若用户上传大写后缀的文件（如.PNG）会匹配失败。可修改正则为大小写不敏感模式：/(.|/)(gif|jpe?g|png)$/i，同时确认前端是否因匹配失败但未正确渲染提示信息。

• 检查PrimeFaces与Tomcat版本兼容性
  确认所使用的PrimeFaces版本与Tomcat8.5兼容，部分旧版本PrimeFaces在Tomcat8.5上存在文件上传的已知bug，可尝试升级PrimeFaces到兼容版本。

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