Tomcat 8.5.98 ErrorReportValve未处理50X错误的配置问题排查

核心问题分析 #

你配置的ErrorReportValve对40X错误生效，但500、503错误无法触发自定义页面跳转，常见原因集中在错误触发层级和配置优先级上：

1. 应用级错误处理拦截了容器层Valve #

ErrorReportValve只处理Tomcat容器直接生成的错误响应，而你通过修改数据源触发的500错误属于应用程序抛出的异常，如果应用自身有以下处理逻辑，会优先于Valve生效：

• 应用web.xml中配置了<error-page>节点：

  <error-page>
      <error-code>500</error-code>
      <location>/error/500.jsp</location>
  </error-page>
  

  这种配置会覆盖Valve的跳转规则，Tomcat会优先使用web.xml定义的错误页面。
• 应用框架（如Spring MVC）的全局异常处理器：如果用@ControllerAdvice或自定义拦截器捕获了异常并返回响应，异常不会抛到Tomcat容器层，Valve自然无法触发。

2. 相对路径解析问题 #

虽然你确认文件路径正确，但ErrorReportValve的路径解析逻辑可能因配置位置不同而变化：

• 如果Valve配置在<Host>节点下，路径是相对于Host的appBase（默认webapps）下的默认ROOT应用；
• 如果配置在<Context>节点下，路径是相对于当前应用的根目录。
  建议尝试使用绝对路径测试：

  <Valve className="org.apache.catalina.valves.ErrorReportValve"
        showReport="false" showServerInfo="false"
        errorCode.400="static/400.html"
        errorCode.401="static/401.html"
        errorCode.403="static/403.html"
        errorCode.404="static/404.html"
        errorCode.405="static/405.html"
        errorCode.408="static/408.html"
        errorCode.413="static/413.html"
        errorCode.500="/opt/tomcat/webapps/ROOT/static/500.html"
        errorCode.503="/opt/tomcat/webapps/ROOT/static/503.html"
      />
  

3. 异常未被抛至容器层 #

如果应用代码中捕获了数据源异常（如SQLException），但未重新抛出或设置响应状态码，Tomcat容器不会生成500错误响应：

try {
    // 数据源操作
} catch (SQLException e) {
    // 仅打印日志，未抛出或设置响应状态
    log.error("DB error", e);
}

这种情况需要修改代码，要么重新抛出异常，要么手动设置响应状态码：

response.setStatus(HttpServletResponse.SC_INTERNAL_SERVER_ERROR);

排查步骤 #

1. 检查应用web.xml，注释或删除针对500、503的<error-page>配置；
2. 查看应用代码/框架配置，确认异常是否被拦截处理，确保异常能传递到Tomcat容器；
3. 替换为绝对路径测试500、503的跳转配置；
4. 查看Tomcat日志（catalina.out、localhost.log），搜索500错误发生时的容器处理日志，确认是否有Valve相关的执行记录。

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