SpringBoot错误页面的原理,你知道吗?

开发 前端
通过分析,默认情况下springboot容器启动后会像tomcat容器中注册一个/error的错误页,这个/error又是谁呢?

环境:Springboot3.0.5

错误消息格式

有如下接口:

@RestController
@RequestMapping("/demo")
public class DemoController {


  @GetMapping("/index")
  public Object index() {
    System.out.println(1 / 0) ;
    return "/demo/index" ;
  }
  
}

当访问上面接口后,默认情况下Springboot会返回如下错误信息:

图片

当请求的Accept是text/html返回的是HTML结果,当Accpet是application/json返回如下:

图片

后台接口会根据不同的Accept返回不同的数据格式。

错误处理原理

Springboot在启动过程中会执行如下处理:

public abstract class AbstractApplicationContext {
  public void refresh() {
    onRefresh();
  }
}

ServletWebServerApplicationContext

public class ServletWebServerApplicationContext {
  protected void onRefresh() {
    super.onRefresh();
    try {
      // 创建web服务
      createWebServer();
    } catch (Throwable ex) {
      throw new ApplicationContextException("Unable to start web server", ex);
    }
  }
  private void createWebServer() {
    // 这里假设我们使用的是Tomcat容器,那么这里的factory = TomcatServletWebServerFactory
    this.webServer = factory.getWebServer(getSelfInitializer());
  }
}

TomcatServletWebServerFactory

public class TomcatServletWebServerFactory {
  public WebServer getWebServer(ServletContextInitializer... initializers) {
    // 创建Tomcat实例
    Tomcat tomcat = new Tomcat();
    // ...
    // 准备上下文
    prepareContext(tomcat.getHost(), initializers);
    return getTomcatWebServer(tomcat);
  }
  protected void prepareContext(Host host, ServletContextInitializer[] initializers) {
    // 该类继承自StandardContext类(该类所属tomcat,每一个StandardContext代表了一个webapp)
    TomcatEmbeddedContext context = new TomcatEmbeddedContext();
    // ...
    // 配置上下文
    configureContext(context, initializersToUse);
  }
  // 配置上下文
  protected void configureContext(Context context, ServletContextInitializer[] initializers) {
    // 获取当前Spring容器中配置的ErrorPage,然后注册到Tomcat当前webapp的上下文中
    // 这里其实对应的就是web.xml中配置的错误页
    for (ErrorPage errorPage : getErrorPages()) {
      org.apache.tomcat.util.descriptor.web.ErrorPage tomcatErrorPage = new org.apache.tomcat.util.descriptor.web.ErrorPage();
      tomcatErrorPage.setLocation(errorPage.getPath());
      tomcatErrorPage.setErrorCode(errorPage.getStatusCode());
      tomcatErrorPage.setExceptionType(errorPage.getExceptionName());
      context.addErrorPage(tomcatErrorPage);
    }
  }
}

TomcatServletWebServerFactory类实现了ErrorPageRegistry接口,有如下方法:

// TomcatServletWebServerFactory继承自AbstractConfigurableWebServerFactory
// ConfigurableWebServerFactory接口继承了ErrorPageRegistry接口
public abstract class AbstractConfigurableWebServerFactory implements ConfigurableWebServerFactory {
  public void addErrorPages(ErrorPage... errorPages) {
    this.errorPages.addAll(Arrays.asList(errorPages));
  }
}

下面查看上面的addErrorPages方法是如何被调用的。

在自动配置类中导入了下面的类

@Import({ ServletWebServerFactoryAutoConfiguration.BeanPostProcessorsRegistrar.class})
public class ServletWebServerFactoryAutoConfiguration {
}
// BeanPostProcessorsRegistrar实现了ImportBeanDefinitionRegistrar,用来注册Bean
public static class BeanPostProcessorsRegistrar implements ImportBeanDefinitionRegistrar, BeanFactoryAware {
  public void registerBeanDefinitions(AnnotationMetadata importingClassMetadata, BeanDefinitionRegistry registry) {
    // 注册了BeanPostProcessor类ErrorPageRegistrarBeanPostProcessor
    registerSyntheticBeanIfMissing(registry, "errorPageRegistrarBeanPostProcessor", ErrorPageRegistrarBeanPostProcessor.class);
  }
}
public class ErrorPageRegistrarBeanPostProcessor implements BeanPostProcessor, BeanFactoryAware {
  public Object postProcessBeforeInitialization(Object bean, String beanName) throws BeansException {
    // 判断当前的Bean是否实现了ErrorPageRegistry
    if (bean instanceof ErrorPageRegistry errorPageRegistry) {
      postProcessBeforeInitialization(errorPageRegistry);
    }
    return bean;
  }
  private void postProcessBeforeInitialization(ErrorPageRegistry registry) {
    // 遍历所有的ErrorPageRegistrar,注册到当前实现了ErrorPageRegistry接口的Bean中
    // 如上面的TomcatServletWebServerFactory
    for (ErrorPageRegistrar registrar : getRegistrars()) {
      registrar.registerErrorPages(registry);
    }
  }
  private Collection<ErrorPageRegistrar> getRegistrars() {
    if (this.registrars == null) {
      // 获取容器中所有的ErrorPageRegistrar Bean对象
      this.registrars = new ArrayList<>(this.beanFactory.getBeansOfType(ErrorPageRegistrar.class, false, false).values());
      this.registrars.sort(AnnotationAwareOrderComparator.INSTANCE);
      this.registrars = Collections.unmodifiableList(this.registrars);
    }
    return this.registrars;
  }
}

接下来就是从容器中获取ErrorPageRegistrar,然后注册到ErrorPageRegistry中。

在如下自动配置类中定义了一个默认的错误页对象。

public class ErrorMvcAutoConfiguration {
  @Bean
  public ErrorPageCustomizer errorPageCustomizer(DispatcherServletPath dispatcherServletPath) {
    return new ErrorPageCustomizer(this.serverProperties, dispatcherServletPath);
  }
  static class ErrorPageCustomizer implements ErrorPageRegistrar, Ordered {
    // springboot配置文件中的server接口中获取error配置信息
    private final ServerProperties properties;


    private final DispatcherServletPath dispatcherServletPath;


    protected ErrorPageCustomizer(ServerProperties properties, DispatcherServletPath dispatcherServletPath) {
      this.properties = properties;
      this.dispatcherServletPath = dispatcherServletPath;
    }


    @Override
    public void registerErrorPages(ErrorPageRegistry errorPageRegistry) {
      // 获取server.error.path配置属性
      ErrorPage errorPage = new ErrorPage(this.dispatcherServletPath.getRelativePath(this.properties.getError().getPath()));
      errorPageRegistry.addErrorPages(errorPage);
    }
  }
}
@ConfigurationProperties(prefix = "server", ignoreUnknownFields = true)
public class ServerProperties {
  @NestedConfigurationProperty
  private final ErrorProperties error = new ErrorProperties();
}
public class ErrorProperties {
  // 读取error.path配置,如果没有配置,则默认是/error
  @Value("${error.path:/error}")
  private String path = "/error";
}

通过上面的分析,默认情况下springboot容器启动后会像tomcat容器中注册一个/error的错误页,这个/error又是谁呢?

默认错误Controller

在默认的错误页自动配置中:

public class ErrorMvcAutoConfiguration {
  @Bean
  @ConditionalOnMissingBean(value = ErrorAttributes.class, search = SearchStrategy.CURRENT)
  public DefaultErrorAttributes errorAttributes() {
    return new DefaultErrorAttributes();
  }


  // 该Controller就是默认的/error错误跳转的类
  @Bean
  @ConditionalOnMissingBean(value = ErrorController.class, search = SearchStrategy.CURRENT)
  public BasicErrorController basicErrorController(ErrorAttributes errorAttributes, ObjectProvider<ErrorViewResolver> errorViewResolvers) {
    return new BasicErrorController(errorAttributes, this.serverProperties.getError(),errorViewResolvers.orderedStream().toList());
  }
}
@Controller
@RequestMapping("${server.error.path:${error.path:/error}}")
public class BasicErrorController extends AbstractErrorController {
  // 当请求的Accept=text/html时调用该方法
  @RequestMapping(produces = MediaType.TEXT_HTML_VALUE)
  public ModelAndView errorHtml(HttpServletRequest request, HttpServletResponse response) {
    // ...
  }
  // 当请求的Accept=application/json时调用该方法
  @RequestMapping
  public ResponseEntity<Map<String, Object>> error(HttpServletRequest request) {
    HttpStatus status = getStatus(request);
    if (status == HttpStatus.NO_CONTENT) {
      return new ResponseEntity<>(status);
    }
    Map<String, Object> body = getErrorAttributes(request, getErrorAttributeOptions(request, MediaType.ALL));
    return new ResponseEntity<>(body, status);
  }
}

以上就是当springboot默认情况下发生错误时的执行输出原理。

责任编辑:武晓燕 来源: 实战案例锦集
相关推荐

2024-02-19 00:00:00

Console函数链接库

2024-02-26 08:19:00

WebSpring容器

2024-04-30 09:02:48

2023-04-26 10:21:04

2023-12-12 08:41:01

2023-12-20 08:23:53

NIO组件非阻塞

2024-05-28 09:12:10

2024-04-07 00:00:00

ESlint命令变量

2019-06-14 15:36:13

Windows 10安全PC

2024-01-09 07:29:05

Argo代码库应用程序

2021-02-02 08:21:28

网络面试通信

2022-05-27 08:55:15

工具自动化软件

2020-10-28 11:20:55

vue项目技

2017-10-16 13:45:04

2024-07-30 08:22:47

API前端网关

2022-06-24 08:20:04

CAP网络通信

2021-12-08 07:31:40

Linux安全病毒

2019-12-12 09:23:29

Hello World操作系统函数库

2024-08-20 08:29:55

2024-04-07 00:00:03

点赞
收藏

51CTO技术栈公众号