Jetty项目中的RequestDispatcher异常回归问题分析

Jetty作为一个广泛使用的Java Web服务器和Servlet容器，在12.0.22版本中引入了一个关于RequestDispatcher异常处理的回归问题。这个问题主要影响了EE9和EE8兼容层，而EE10及以上版本则不受影响。

问题背景

在Servlet规范中，getRequestDispatcher()方法用于获取一个RequestDispatcher对象，该对象可以用于将请求转发或包含其他资源。当传入的路径参数不合法时，Servlet容器应该抛出适当的异常。

在Jetty 12.0.22版本之前，当传入非法路径或查询字符串时，Jetty会抛出BadMessageException。然而，在12.0.22版本中，这一行为被意外修改为抛出IllegalStateException，这导致了与之前版本的兼容性问题。

技术细节

这个问题涉及两个主要接口的方法：

1. HttpServletRequest.getRequestDispatcher(String)
2. ServletContext.getRequestDispatcher(String)

非法输入包括两种类型：

• 非法路径（如包含不合法字符或格式错误的路径）
• 非法查询字符串（如格式错误的查询参数）

值得注意的是，某些类型的非法输入会在getRequestDispatcher()调用时立即触发异常，而其他类型的非法输入则会在后续调用RequestDispatcher.forward()或RequestDispatcher.include()时才抛出异常。

影响范围

这个问题特别影响了：

• 使用Jetty EE9兼容层的应用程序
• 使用Jetty EE8兼容层的应用程序
• 依赖于特定异常类型进行错误处理的代码

EE10及以上版本不受此问题影响，因为它们已经采用了新的异常处理策略，使用IllegalStateException是符合预期的。

解决方案

Jetty团队迅速响应并修复了这个问题。修复方案包括：

1. 恢复EE9/EE8兼容层中的原始异常行为，继续使用BadMessageException
2. 确保EE10及以上版本保持使用IllegalStateException的行为

这个修复确保了向后兼容性，同时不影响新版本的行为规范。

开发者建议

对于使用Jetty的开发者，建议：

1. 如果应用程序依赖于特定的异常类型进行错误处理，应该检查是否受此变更影响
2. 在升级Jetty版本时，特别注意12.0.22版本中的这一变化
3. 考虑将异常处理逻辑设计为更通用的方式，而不是依赖于特定的异常类型

总结

Jetty 12.0.22版本中引入的这个回归问题展示了兼容性维护的挑战。Jetty团队通过快速响应和精确修复，既保持了旧版本的行为一致性，又不影响新版本的发展方向。这体现了Jetty项目对稳定性和兼容性的重视，以及对开发者体验的关注。