Primefaces ExceptionHandler视图过期时失效问题咨询

我之前碰到过一模一样的问题，这种情况本质上是视图过期后，容器的默认异常处理逻辑抢占了PrimeFaces Ajax异常处理器的执行权，导致前端收到的是原始XML错误响应，而非能触发弹窗的PrimeFaces Ajax响应。下面是一步步的排查和解决方法：

1. 移除Web容器对ViewExpiredException的全局错误页面配置 #

如果你的web.xml里给ViewExpiredException配置了错误页面，容器会直接返回这个错误页面的XML内容，根本轮不到PrimeFaces的AjaxExceptionHandler处理。

错误示例（要删掉）：

<error-page>
    <exception-type>javax.faces.application.ViewExpiredException</exception-type>
    <location>/expired.xhtml</location>
</error-page>

如果一定要保留错误页面，确保它是Facelets页面，并且不要用faces-redirect=true，让请求停留在Faces生命周期内，给PrimeFaces处理器留机会。

2. 确认AjaxExceptionHandler的注册正确性 #

检查你的faces-config.xml里是否正确注册了PrimeFaces的异常处理器工厂，而且要确保没有被自定义的工厂覆盖：

<factory>
    <exception-handler-factory>org.primefaces.application.exceptionhandler.AjaxExceptionHandlerFactory</exception-handler-factory>
</factory>

这个配置要放在所有自定义异常处理器工厂之前（如果有的话），保证PrimeFaces的处理器优先执行。

3. 自定义异常处理器，强制拦截ViewExpiredException #

有时候容器会把ViewExpiredException包装成ServletException，默认的AjaxExceptionHandler可能抓不到。可以自定义一个处理器，手动解析根异常：

自定义异常处理器类 #

public class CustomViewExpiredExceptionHandler extends AjaxExceptionHandler {

    public CustomViewExpiredExceptionHandler(ExceptionHandler wrapped) {
        super(wrapped);
    }

    @Override
    public void handle() throws FacesException {
        FacesContext fc = FacesContext.getCurrentInstance();
        ExceptionQueuedEvent event = getExceptionQueuedEvents().iterator().next();
        Throwable rootCause = getRootCause(event.getContext().getException());

        // 精准捕获视图过期异常
        if (rootCause instanceof ViewExpiredException) {
            // 构造PrimeFaces能识别的Ajax响应，触发弹窗
            String script = "PF('expiredDialog').show();";
            fc.getPartialViewContext().getEvalScripts().add(script);
            fc.renderResponse();
        } else {
            // 其他异常交给父类处理
            super.handle();
        }
    }

    // 递归获取根异常
    private Throwable getRootCause(Throwable throwable) {
        while (throwable.getCause() != null) {
            throwable = throwable.getCause();
        }
        return throwable;
    }
}

注册自定义处理器工厂 #

public class CustomExceptionHandlerFactory extends ExceptionHandlerFactory {
    private final ExceptionHandlerFactory parent;

    public CustomExceptionHandlerFactory(ExceptionHandlerFactory parent) {
        this.parent = parent;
    }

    @Override
    public ExceptionHandler getExceptionHandler() {
        return new CustomViewExpiredExceptionHandler(parent.getExceptionHandler());
    }
}

然后在faces-config.xml里替换原有的工厂配置：

<factory>
    <exception-handler-factory>com.yourpackage.CustomExceptionHandlerFactory</exception-handler-factory>
</factory>

4. 前端弹窗的配置注意事项 #

确保你的弹窗使用PrimeFaces的widgetVar，并且没有被其他逻辑阻塞：

<p:commandButton value="触发视图过期" action="#{yourBean.triggerViewExpire}" />

<p:dialog widgetVar="expiredDialog" header="会话过期" modal="true" closable="true">
    <h:outputText value="您的会话已过期，请重新加载页面后重试。" />
    <p:button value="刷新页面" onclick="location.reload();" />
</p:dialog>

这里不需要在按钮上写oncomplete，因为视图过期时请求不会正常完成，弹窗的显示完全依赖后端异常处理器返回的脚本。

最后验证 #

1. 打开页面后，等待会话过期（可以手动设置服务器会话超时时间测试）
2. 点击按钮，查看浏览器控制台的响应，应该是包含PF('expiredDialog').show();的PrimeFaces Ajax响应，而非原始XML错误
3. 弹窗正常弹出

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