Jetty项目中ErrorHandler的getShowMessageInTitle方法失效问题解析

在Jetty项目的历史版本中，org.eclipse.jetty.ee9.nested.ErrorHandler类存在一个长期未被发现的Bug：getShowMessageInTitle()方法虽然存在但从未被实际调用。这个问题最早可以追溯到Jetty 9.4版本，并且一直延续到Jetty 12.0的EE8和EE9实现中。

问题背景

ErrorHandler是Jetty用于处理HTTP错误响应的核心组件，负责生成错误页面。开发者通常通过配置ErrorHandler来控制错误页面中显示的信息量，包括：

• 是否显示错误消息（showMessageInTitle）
• 是否显示Servlet信息（showServlet）
• 是否显示堆栈跟踪（showStacks）

然而在实际使用中发现，通过setShowMessageInTitle(false)配置并不能有效隐藏错误消息，因为相关判断逻辑从未被执行。

技术细节分析

在writeErrorPageHead方法中，虽然存在以下判断逻辑：

if (getShowMessageInTitle() && message != null && !message.equals(status)) {
    writer.write(' ');
    writer.write(StringUtil.sanitizeXmlString(message));
}

但这个方法从未被调用，导致配置失效。同时，方法命名也存在不符合JavaBean规范的问题，应该使用isShowMessageInTitle()而非getShowMessageInTitle()。

版本演进与修复

Jetty团队在维护过程中遵循"bug-for-bug"兼容性原则，因此在EE8和EE9实现中保留了这个问题以保证向后兼容。但在Jetty 12.1的EE11实现中，这个问题已经得到修复，因为新的ErrorHandler继承自核心ErrorHandler并进行了重构。

开发者应对方案

对于使用Jetty 12.0及以下版本的开发者，如果需要在错误页面中隐藏敏感信息，可以采取以下替代方案：

1. 自定义ErrorHandler实现，重写writeErrorPageHead方法
2. 使用其他配置项如setShowServlet(false)和setShowStacks(false)来控制信息显示
3. 考虑升级到Jetty 12.1及以上版本

总结

这个Bug揭示了长期存在于Jetty中的一个小但重要的功能缺失。它提醒我们在使用开源组件时，不仅要关注文档说明，还需要通过实际测试验证功能是否符合预期。对于框架开发者而言，这也体现了保持向后兼容与修复历史问题之间的平衡考量。

随着Jetty项目的持续演进，类似的历史遗留问题正在被逐步解决，开发者可以期待在未来的版本中获得更加一致和可靠的行为表现。