JBoss EAP 7迁移后RichFaces 3 FileUpload InputStream为空问题排查

我之前帮团队处理过几乎一模一样的迁移场景——从EAP6（基于Tomcat）迁到EAP7（Undertow），RichFaces 3.3的文件上传就是踩了这个坑。核心原因是RichFaces 3.3的MultipartRequest实现完全是针对旧Servlet容器写的，和Undertow的请求流处理逻辑不兼容，导致它无法正确读取到上传的内容。下面给你几个可行的解决方案，按推荐优先级排序：

1. 禁用RichFaces自带的Multipart处理，改用Servlet 3.0原生API #

这是改动最小、见效最快的方案，因为EAP7支持Java EE7（Servlet 3.0+），原生API已经能很好处理文件上传：

• 首先在web.xml里添加参数，关闭RichFaces的Multipart处理：

  <context-param>
      <param-name>org.ajax4jsf.handleMultipartRequest</param-name>
      <param-value>false</param-value>
  </context-param>
  

• 然后修改你的文件上传处理代码，替换掉原来依赖MultipartRequest的逻辑，改用Servlet原生的HttpServletRequest.getPart()方法：

  // 原来的旧代码（依赖RichFaces）
  // MultipartRequest multipartRequest = (MultipartRequest) request;
  // InputStream fileStream = multipartRequest.getFileStream("uploadedFile");
  
  // 新的Servlet 3.0代码
  Part filePart = request.getPart("uploadedFile"); // 这里的名字对应前端<rich:fileUpload>的id或name
  InputStream fileStream = filePart.getInputStream();
  // 后续的文件处理逻辑保持不变即可
  

2. 调整Undertow的Multipart配置 #

有时候Undertow默认的Multipart参数设置会限制请求大小，导致流被截断或者无法解析，你可以在EAP7的standalone.xml（或domain.xml）里调整Undertow的servlet容器配置：

<subsystem xmlns="urn:jboss:domain:undertow:12.0" default-server="default-server" default-virtual-host="default-host" default-servlet-container="default" default-security-domain="other">
  <servers>
    <server name="default-server">
      <http-listener name="default" socket-binding="http" redirect-socket="https"/>
      <host name="default-host" alias="localhost">
        <location name="/" handler="welcome-content"/>
        <filter-ref name="server-header"/>
        <filter-ref name="x-powered-by-header"/>
      </host>
    </server>
  </servers>
  <servlet-containers>
    <servlet-container name="default">
      <!-- 调整Multipart的大小限制，根据你的业务需求设置 -->
      <multipart-config max-file-size="50000000" max-request-size="50000000" file-size-threshold="1000000"/>
      <jsp-config/>
    </servlet-container>
  </servlet-containers>
  <!-- 其他配置... -->
</subsystem>

修改后记得重启JBoss，确保配置生效。

3. 尝试升级RichFaces版本（可选） #

如果项目允许做一定程度的代码调整，可以考虑把RichFaces 3.3升级到4.x版本（比如4.5.x），这个版本已经适配了Servlet 3.0和Undertow容器，文件上传的问题会自然解决。不过要注意：

• RichFaces 4.x的组件标签和API有不少变化，比如<rich:fileUpload>的属性、事件处理逻辑都和3.3不一样，需要调整前端页面和后端代码。
• 4.x版本同样已经停止维护，但兼容性比3.3好很多。

4. 调试流读取过程（排查用） #

如果上面的方法都没解决问题，可以加一段调试代码，确认Undertow是否真的没有传递流：

ServletInputStream inputStream = request.getInputStream();
// 打印流的状态
System.out.println("Stream is finished: " + inputStream.isFinished());
System.out.println("Stream is ready: " + inputStream.isReady());
// 尝试手动读取部分内容
byte[] buffer = new byte[1024];
int bytesRead = inputStream.read(buffer);
System.out.println("Bytes read from stream: " + bytesRead);

如果手动读取能拿到内容，那问题肯定出在RichFaces的MultipartRequest实现上，直接用方案1替换即可；如果手动读取也拿不到，那就要检查前端的请求是否正确发送，或者Undertow的配置有没有问题。

内容的提问来源于stack exchange，提问作者Pau Gómez