SpringBoot通过main方法启动web项目实践

 更新时间:2025年08月18日 14:15:12   作者:dj_master  
SpringBoot通过SpringApplication.run()启动Web项目,自动推断应用类型,加载初始化器与监听器,配置SpringMVC组件,启动嵌入式服务器,实现零配置启动

Spring Boot 通过 main 方法启动 Web 项目的过程涉及多个核心组件和自动化机制,下面从源码角度详细拆解:

1. 启动入口:SpringApplication.run()

@SpringBootApplication
public class DemoApplication {
    public static void main(String[] args) {
        SpringApplication.run(DemoApplication.class, args);
    }
}

SpringApplication.run() 是启动的核心入口,它主要完成以下工作:

2. SpringApplication初始化

// SpringApplication 构造函数核心逻辑
public SpringApplication(ResourceLoader resourceLoader, Class<?>... primarySources) {
    // 1. 设置资源加载器
    this.resourceLoader = resourceLoader;
    // 2. 校验并保存主配置类(即 @SpringBootApplication 标注的类)
    this.primarySources = new LinkedHashSet<>(Arrays.asList(primarySources));
    // 3. 推断应用类型(REACTIVE、SERVLET、NONE)
    this.webApplicationType = WebApplicationType.deduceFromClasspath();
    // 4. 加载并实例化 ApplicationContextInitializer
    setInitializers((Collection) getSpringFactoriesInstances(ApplicationContextInitializer.class));
    // 5. 加载并实例化 ApplicationListener
    setListeners((Collection) getSpringFactoriesInstances(ApplicationListener.class));
    // 6. 推断 main 方法所在类
    this.mainApplicationClass = deduceMainApplicationClass();
}

关键步骤:

  • 应用类型推断:通过检查类路径中是否存在 org.springframework.web.reactive.DispatcherHandler(REACTIVE)或 javax.servlet.Servlet(SERVLET)来确定应用类型。
  • 初始化器(Initializer):从 META-INF/spring.factories 加载 ApplicationContextInitializer,用于在 ApplicationContext 刷新前自定义配置。
  • 监听器(Listener):加载 ApplicationListener,监听启动过程中的事件(如 ApplicationStartingEvent)。

3. run()方法核心流程

public ConfigurableApplicationContext run(String... args) {
    // 1. 计时和发布启动事件
    StopWatch stopWatch = new StopWatch();
    stopWatch.start();
    ConfigurableApplicationContext context = null;
    Collection<SpringBootExceptionReporter> exceptionReporters = new ArrayList<>();
    configureHeadlessProperty();
    
    // 2. 获取并启动监听器
    SpringApplicationRunListeners listeners = getRunListeners(args);
    listeners.starting();
    
    try {
        // 3. 构建应用参数和环境配置
        ApplicationArguments applicationArguments = new DefaultApplicationArguments(args);
        ConfigurableEnvironment environment = prepareEnvironment(listeners, applicationArguments);
        
        // 4. 创建并配置 ApplicationContext
        context = createApplicationContext();
        exceptionReporters = getSpringFactoriesInstances(SpringBootExceptionReporter.class,
                new Class[] { ConfigurableApplicationContext.class }, context);
        
        // 5. 准备上下文(加载 Bean 定义)
        prepareContext(context, environment, listeners, applicationArguments, printedBanner);
        // 6. 刷新上下文(核心启动逻辑)
        refreshContext(context);
        // 7. 刷新后的回调处理
        afterRefresh(context, applicationArguments);
        // 8. 发布应用就绪事件
        listeners.started(context);
        // 9. 执行 Runner(如 CommandLineRunner)
        callRunners(context, applicationArguments);
    }
    catch (Throwable ex) {
        handleRunFailure(context, ex, exceptionReporters, listeners);
        throw new IllegalStateException(ex);
    }
    
    stopWatch.stop();
    if (this.logStartupInfo) {
        new StartupInfoLogger(this.mainApplicationClass).logStarted(getApplicationLog(), stopWatch);
    }
    // 10. 发布应用运行中事件
    listeners.running(context);
    return context;
}

4. 嵌入式 Web 服务器启动关键点

4.1refreshContext()方法触发服务器启动

private void refreshContext(ConfigurableApplicationContext context) {
    refresh(context);
    if (this.registerShutdownHook) {
        try {
            context.registerShutdownHook();
        }
        catch (AccessControlException ex) {
            // Not allowed in some environments.
        }
    }
}

protected void refresh(ConfigurableApplicationContext context) {
    // 调用 AbstractApplicationContext 的 refresh() 方法
    context.refresh();
}

4.2ServletWebServerApplicationContext的核心作用

对于 Web 应用,ApplicationContext 实际类型为 AnnotationConfigServletWebServerApplicationContext,它继承自 ServletWebServerApplicationContext,后者在 refresh() 过程中会:

// ServletWebServerApplicationContext 核心方法
@Override
protected void onRefresh() {
    super.onRefresh();
    try {
        // 创建并启动嵌入式 Web 服务器
        createWebServer();
    }
    catch (Throwable ex) {
        throw new ApplicationContextException("Unable to start web server", ex);
    }
}

private void createWebServer() {
    WebServer webServer = this.webServer;
    ServletContext servletContext = getServletContext();
    
    if (webServer == null && servletContext == null) {
        // 1. 获取 ServletWebServerFactory(如 TomcatServletWebServerFactory)
        ServletWebServerFactory factory = getWebServerFactory();
        // 2. 创建并配置 Web 服务器
        this.webServer = factory.getWebServer(getSelfInitializer());
    }
    else if (servletContext != null) {
        try {
            getSelfInitializer().onStartup(servletContext);
        }
        catch (ServletException ex) {
            throw new ApplicationContextException("Cannot initialize servlet context", ex);
        }
    }
    initPropertySources();
}

4.3ServletWebServerFactory实例化服务器

以 Tomcat 为例,TomcatServletWebServerFactorygetWebServer() 方法会:

@Override
public WebServer getWebServer(ServletContextInitializer... initializers) {
    // 1. 创建 Tomcat 实例
    Tomcat tomcat = new Tomcat();
    // 2. 配置服务器基本参数(端口、上下文路径等)
    File baseDir = (this.baseDirectory != null) ? this.baseDirectory : createTempDir("tomcat");
    tomcat.setBaseDir(baseDir.getAbsolutePath());
    Connector connector = new Connector(this.protocol);
    tomcat.getService().addConnector(connector);
    customizeConnector(connector);
    tomcat.setConnector(connector);
    tomcat.getHost().setAutoDeploy(false);
    // 3. 配置 ServletContextInitializer(如 DispatcherServlet)
    prepareContext(tomcat.getHost(), initializers);
    // 4. 启动服务器
    return getTomcatWebServer(tomcat);
}

5. Spring MVC 组件自动配置

通过 WebMvcAutoConfiguration 自动配置核心组件:

  • DispatcherServlet:作为前端控制器,处理所有 HTTP 请求。
  • HandlerMapping:映射 URL 到具体的 Controller 方法。
  • ViewResolver:解析视图名称到实际视图。

关键代码(WebMvcAutoConfiguration):

@Bean
@Primary
@ConditionalOnMissingBean(DispatcherServlet.class)
public DispatcherServlet dispatcherServlet(WebMvcProperties properties) {
    DispatcherServlet dispatcherServlet = new DispatcherServlet();
    dispatcherServlet.setDispatchOptionsRequest(properties.isDispatchOptionsRequest());
    dispatcherServlet.setDispatchTraceRequest(properties.isDispatchTraceRequest());
    dispatcherServlet.setThrowExceptionIfNoHandlerFound(properties.isThrowExceptionIfNoHandlerFound());
    dispatcherServlet.setPublishEvents(properties.isPublishRequestHandledEvents());
    dispatcherServlet.setEnableLoggingRequestDetails(properties.isLogRequestDetails());
    return dispatcherServlet;
}

6. 最终启动结果

  • 嵌入式服务器(如 Tomcat)启动并监听指定端口(默认 8080)。
  • DispatcherServlet 注册到 Servlet 容器,作为所有请求的入口。
  • Spring 上下文初始化完成,所有 Bean 已加载并可用。
  • ApplicationReadyEvent 发布,标志应用可处理外部请求。

总结:启动流程关键点

  1. SpringApplication 初始化:推断应用类型、加载初始化器和监听器。
  2. 环境配置:加载 application.properties 等配置源。
  3. ApplicationContext 创建:根据 Web 类型选择相应的上下文实现。
  4. 自动配置:基于依赖和条件注解,自动配置 Web 组件(如 DispatcherServlet)。
  5. 嵌入式服务器启动:通过 ServletWebServerFactory 创建并启动 Tomcat/Jetty。
  6. Spring MVC 初始化:配置请求映射、视图解析等核心组件。

通过这种机制,Spring Boot 实现了“零配置”启动 Web 项目的能力,开发者只需关注业务逻辑,无需手动处理服务器配置和组件装配。

以上为个人经验,希望能给大家一个参考,也希望大家多多支持脚本之家。

相关文章

  • java随机生成8位数授权码的实例

    java随机生成8位数授权码的实例

    下面小编就为大家带来一篇java随机生成8位数授权码的实例。小编觉得挺不错的,现在就分享给大家,也给大家做个参考。一起跟随小编过来看看吧
    2017-02-02
  • SpringBoot教程_创建第一个SpringBoot项目

    SpringBoot教程_创建第一个SpringBoot项目

    这篇文章主要介绍了SpringBoot教程_创建第一个SpringBoot项目,具有很好的参考价值,希望对大家有所帮助。如有错误或未考虑完全的地方,望不吝赐教
    2022-06-06
  • 详解Java模拟栈的实现以及Stack类的介绍

    详解Java模拟栈的实现以及Stack类的介绍

    栈是一种数据结构,它按照后进先出的原则来存储和访问数据。Stack是一个类,表示栈数据结构的实现。本文就来和大家介绍一下Java模拟栈的实现以及Stack类的使用,需要的可以参考一下
    2023-04-04
  • 使用FeignClient进行微服务交互方式(微服务接口互相调用)

    使用FeignClient进行微服务交互方式(微服务接口互相调用)

    这篇文章主要介绍了使用FeignClient进行微服务交互方式(微服务接口互相调用),具有很好的参考价值,希望对大家有所帮助。如有错误或未考虑完全的地方,望不吝赐教
    2022-03-03
  • Spring Cloud Gateway打造可扩展的微服务网关

    Spring Cloud Gateway打造可扩展的微服务网关

    微服务网关是一个位于客户端和后端微服务之间的服务器,用于处理所有与客户端的通信,Spring Cloud Gateway都是一个值得考虑的选择,它将帮助您更好地管理和保护您的微服务,感兴趣的朋友一起看看吧
    2023-11-11
  • java Spring AOP详解及简单实例

    java Spring AOP详解及简单实例

    这篇文章主要介绍了java Spring AOP详解及简单实例的相关资料,需要的朋友可以参考下
    2017-05-05
  • 学生视角带你了解Java内部类

    学生视角带你了解Java内部类

    说起内部类这个词,想必很多人都不陌生,但是又会觉得不熟悉。原因是平时编写代码时可能用到的场景不多,用得最多的是在有事件监听的情况下,并且即使用到也很少去总结内部类的用法。今天我们就来一探究竟
    2022-03-03
  • Spring调用this导致事务失效的三种解决方案

    Spring调用this导致事务失效的三种解决方案

    在 Spring 事务管理 中,如果你在同一个类的方法内部使用 this.xxx() 调用另一个带 @Transactional 的方法,事务很可能会失效,这不是玄学,而是代理机制在背后打盹了,本文就给大家介绍如何解决this调用导致事务失效问题,需要的朋友可以参考下
    2026-02-02
  • 一篇文章带你入门Java UML的类图

    一篇文章带你入门Java UML的类图

    这篇文章主要为大家详细介绍了Java UML的类图,文中示例代码介绍的非常详细,具有一定的参考价值,感兴趣的小伙伴们可以参考一下,希望能够给你带来帮助
    2022-02-02
  • 一小时迅速入门Mybatis之Prepared Statement与符号的使用

    一小时迅速入门Mybatis之Prepared Statement与符号的使用

    这篇文章主要介绍了一小时迅速入门Mybatis之Prepared Statement与符号的使用,本文给大家介绍的非常详细,对大家的学习或工作具有一定的参考借鉴价值,需要的朋友可以参考下
    2021-09-09

最新评论