JSF Ajax事件异常处理：ViewExpiredException视图替换异常

这种部分替换的情况我之前在处理JSF和Spring MVC的异常时都碰到过，核心原因基本都是异常处理机制触发了局部渲染而非完整页面渲染，导致错误视图的body内容被插入到原页面的body中，而非替换整个页面。下面给你拆解可能的原因和对应的解决办法：

1. 先排查请求类型：是否是AJAX请求触发的异常？ #

如果触发ViewExpiredException的是AJAX请求（比如页面上的异步操作），很多框架（比如JSF、Spring MVC）默认会只返回视图的body部分内容，而不是完整的HTML文档（包含<html>、<head>、<body>标签）。这是因为AJAX请求通常期望局部更新，容器会自动剥离页面框架只返回内容片段。

解决办法：

• 在异常处理器中判断请求是否为AJAX：检查请求头X-Requested-With是否等于XMLHttpRequest
• 如果是AJAX请求，要么强制触发页面跳转（比如用redirect而不是直接返回视图），要么让前端接收到异常后执行页面跳转

举个JSF自定义异常处理器的例子：

public class ViewExpiredExceptionHandler extends ExceptionHandlerWrapper {
    @Override
    public void handle() throws FacesException {
        FacesContext facesContext = FacesContext.getCurrentInstance();
        ExternalContext externalContext = facesContext.getExternalContext();
        
        for (ExceptionQueuedEvent event : getUnhandledExceptionQueuedEvents()) {
            Throwable exception = event.getContext().getException();
            if (exception instanceof ViewExpiredException) {
                // 强制跳转，确保加载完整错误页面
                try {
                    externalContext.redirect(externalContext.getRequestContextPath() + "/error/expired.xhtml");
                    facesContext.responseComplete();
                    return;
                } catch (IOException e) {
                    throw new FacesException(e);
                }
            }
        }
        getWrapped().handle();
    }
}

2. 检查异常视图的配置和完整性 #

• 确保错误视图是完整的HTML文档：包含<!DOCTYPE html>、<html>、<head>（引入CSS的部分）、<body>等完整结构，而不是仅包含body内的内容片段。如果错误视图是片段，容器自然只会插入这部分内容到原页面。
• 检查框架的异常处理配置：比如在web.xml中配置<error-page>时，要确保location指向的是完整的页面路径，而非片段：

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

3. 确认异常处理器是否触发了完整渲染 #

有些框架的异常处理API如果只是设置视图名称（比如JSF的context.getApplication().getViewHandler().renderView(context, viewId)），可能会保留原请求的渲染上下文，导致局部替换。这时候改用redirect强制触发新的GET请求，就能加载完整的错误页面。

4. 前端层面的兜底处理 #

如果上述后端配置都没问题，还可以在前端加一层判断：当AJAX请求返回的内容包含错误页面的特定标识（比如你的错误body类名），就直接用window.location.href跳转到错误页面URL。

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