WildFly 32.0.1中h:inputFile恢复视图时抛出NoSuchMethodException异常

问题原因 #

这个异常是Undertow的PartImpl类没有无参构造函数导致的。JSF在表单验证失败后恢复视图时，会尝试通过反射实例化保存在视图状态中的Part对象（文件上传组件的值），但PartImpl仅提供带参构造，无法被JSF的视图恢复机制实例化，从而抛出NoSuchMethodException。

解决办法 #

1. 标记文件上传组件为瞬态（推荐） #

给h:inputFile或o:inputFile添加transient="true"属性，让JSF不把Part对象存入视图状态，验证失败后重新渲染页面时不会尝试恢复旧的Part实例，第二次上传时会获取全新的Part对象：

<o:inputFile id="uploadFile" value="#{yourBean.file}" transient="true" />

或标准组件写法：

<h:inputFile id="uploadFile" value="#{yourBean.file}" transient="true" />

2. 手动清理Bean中的Part属性 #

在验证失败后，手动将Bean中绑定的Part属性置为null，避免视图状态保存无效的Part实例。可以通过@PostValidate注解的方法实现：

import jakarta.faces.event.PostValidateEvent;
import jakarta.faces.view.ViewScoped;
import jakarta.inject.Named;
import jakarta.servlet.http.Part;

@Named
@ViewScoped
public class YourBean {
    private Part file;
    // 其他属性、getter/setter方法

    public void postValidate(PostValidateEvent event) {
        // 若存在验证错误，清理file属性
        if (!event.getFacesContext().getMessageList().isEmpty()) {
            this.file = null;
        }
    }
}

同时在页面中绑定该事件：

<f:event type="postValidate" listener="#{yourBean.postValidate}" />

3. 组件版本临时排查 #

如果上述方法无效，可以尝试：

• 升级Omnifaces到最新稳定版（检查是否有针对Undertow Part处理的修复）
• 确认Wildfly的Undertow multipart配置（如max-file-size等参数）正常，但此问题核心不在配置，仅作为辅助排查项

结论 #

这是Undertow与JSF视图恢复机制的兼容问题，不是你遗漏了配置。通过上述瞬态标记或手动清理的方式即可规避该异常。

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