后端返回500错误前端未捕获，控制台显示200状态码求排查

问题描述 #

后端执行以下代码尝试返回内部服务器错误：

if (true) { 
    httpResponse.sendError(HttpServletResponse.SC_INTERNAL_SERVER_ERROR, "error"); 
}

但前端未触发错误捕获逻辑，浏览器控制台显示响应状态码为200、状态文本为"ok"。前端拦截器代码如下：

intercept(req: HttpRequest<any>, next: HttpHandler): Observable<HttpEvent<any>> { 
    return next.handle(req).pipe( 
        map((event: HttpEvent<any>) => { 
            if (event instanceof HttpResponse) { } 
            return event; 
        }), 
        catchError((error: HttpErrorResponse) => { 
            localStorage.clear(); 
            sessionStorage.clear(); 
            this.nav.goToLogin(''); 
            return throwError(error); 
        })
    ); 
}

原因分析 #

这种情况的核心问题是后端的sendError并没有真正把500状态码发送到前端，浏览器收到的200响应是后续被其他逻辑覆盖后的结果，常见场景有以下几种：

1. 全局异常处理器/过滤器覆盖了响应 #

如果你的后端用了Spring Boot这类框架，很可能存在@ControllerAdvice或者自定义Filter，它们捕获了异常（或者拦截了响应），并将响应状态码强制设置为200，同时把错误信息放在响应体里返回。比如有些项目为了统一响应格式，会把所有错误都包装成200状态的JSON返回，这就会导致浏览器显示200，而前端的catchError不会触发（因为只有状态码>=400才会被视为错误进入catchError）。

2. sendError之后执行了修改响应的代码 #

调用sendError后，如果你没有立刻终止请求处理逻辑（比如没有return），后续代码如果调用了response.getWriter()、response.setStatus()或者sendRedirect()等方法，会覆盖之前的sendError设置，导致响应状态码被修改为200。

3. 错误页面配置导致内部转发 #

如果是传统Web项目（比如基于Servlet），web.xml中如果配置了<error-page>映射500错误到某个JSP或Servlet：

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

服务器会对500错误进行内部转发，而转发后的响应状态码会变成200（因为浏览器收到的是转发后页面的响应，而非原始的500错误响应）。

解决方案 #

针对上述可能的原因，你可以按以下步骤排查：

• 检查全局异常处理逻辑：查看项目中是否有@ControllerAdvice、@ExceptionHandler或者自定义Filter，确认它们是否将错误响应的状态码设置为了200。如果是统一响应格式的需求，建议保留错误状态码（比如设置为500），这样前端才能通过catchError捕获。
• 终止sendError后的代码执行：调用sendError后，立刻添加return语句终止当前方法，避免后续代码修改响应：

  if (true) { 
      httpResponse.sendError(HttpServletResponse.SC_INTERNAL_SERVER_ERROR, "error"); 
      return; // 终止后续逻辑
  }
  

• 检查错误页面配置：如果是传统Web项目，查看web.xml中的<error-page>配置，若不需要自定义错误页面可以暂时注释掉，测试是否能正常返回500状态码；若需要自定义错误页面，可以考虑使用sendRedirect替代内部转发（但redirect会改变URL），或者在错误页面中手动设置状态码。
• 前端验证：可以用Postman直接调用后端接口，确认接口实际返回的状态码是500还是200，这能快速定位问题是在后端还是前端（如果Postman也显示200，那肯定是后端的问题）。

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