Wicket 9.12.0中通过IRequestCycleListener跳转带参错误页失败问题

问题原因 #

你遇到的核心问题是：在IRequestCycleListener.onException()中返回了null，这会让Wicket框架认为该异常未被完全处理，进而触发默认的异常处理逻辑（输出异常堆栈），覆盖了你通过cycle.setResponsePage()设置的错误页。

虽然你的ErrorPage带参构造方法已经执行，但Wicket后续的默认异常处理流程会接管响应输出，导致最终显示的是堆栈信息而非错误页内容。

解决方案 #

修改IRequestCycleListener的实现，在处理完异常后返回一个RenderPageRequestHandler实例，明确告诉Wicket该异常已被处理，无需再执行默认逻辑：

getRequestCycleListeners().add(new IRequestCycleListener() {
    @Override
    public IRequestHandler onException(RequestCycle cycle, Exception ex) {
        if (ex instanceof RuntimeException) {
            PageParameters pageParameters = new PageParameters();
            pageParameters.add("errorCode", 500);
            // 创建并返回RenderPageRequestHandler，替代返回null
            return new RenderPageRequestHandler(new PageProvider(ErrorPage.class, pageParameters));
        }
        // 非RuntimeException的情况，返回null让框架继续处理
        return null;
    }
});

补充说明 #

• 关于你提到的「未处理的RuntimeException」：这不是直接原因，你已经在代码中捕获并处理了RuntimeException，但返回null的行为让Wicket误以为处理未完成。
• 如果要统一处理所有异常，只需去掉if (ex instanceof RuntimeException)的判断，直接对所有异常执行错误页跳转逻辑即可：

@Override
public IRequestHandler onException(RequestCycle cycle, Exception ex) {
    PageParameters pageParameters = new PageParameters();
    // 根据异常类型或内容设置对应的errorCode
    if (ex instanceof RuntimeException) {
        pageParameters.add("errorCode", 500);
    } else {
        pageParameters.add("errorCode", 400);
    }
    return new RenderPageRequestHandler(new PageProvider(ErrorPage.class, pageParameters));
}

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