Apache Solr 启动过程源码分析

一、环境准备与调试方法

1. 调试参数命令：

   java -Xdebug -Xrunjdwp:transport=dt_socket,address=10010,server=y,suspend=y -jar start.jar --module=http
   

2. 源码配置：

   • 下载Solr源码
   • 配置IDE(如IntelliJ IDEA)的Remote调试

二、Jetty容器启动过程分析

1. WebAppContext初始化

• 主要工作：
  • 解压war包并创建工作目录
  • 将WEB-INF/classes和依赖jar包加入classpath
  • 创建应用ClassLoader
  • 构建Handler链(SessionHandler、SecurityHandler、ServletHandler、WebAppContext)

2. 启动流程调用栈

1. WebAppContext.doStart()

   • 加载solr-home/server/lib/和webapp/WEB-INF/lib/下的jar包
   • 调用preConfigure()方法

2. ServletContextHandler.doStart()

   • 管理三个核心Handler：
     • ServletHandler
     • SessionHandler
     • SecurityHandler

3. ContextHandler.doStart()

   • 实现CycleLife和Handler接口
   • 重写doStart()方法

4. WebAppContext.startContext()

   • 调用configure()方法
   • 解析元数据(resolve)
   • 调用startWebapp()

5. ServletContextHandler.startContext()

   • 将各Handler组成处理链
   • 初始化ServletHandler

6. ScopedHandler.doStart()

   • 处理Handler链
   • 核心在doScope方法

7. ContainerLifeCycle.doStart()

   • 生命周期管理
   • 依次启动各Handler

8. ServletHandler.initialize()

   • 初始化Web应用
   • 加载web.xml中定义的Filter

三、Solr核心启动过程

1. SolrDispatchFilter初始化

• 类图关系：

  SolrDispatchFilter -> Filter -> FilterHolder -> ServletHandler
  

• init()方法主要工作：

  • 创建并初始化Config对象
  • 创建CoreContainer
  • 初始化this.cores属性

2. createCoreContainer方法

• 核心功能：

  • 加载并解析solr.xml配置
  • 返回CoreContainer实例

• 调用栈：

  fromSolrHome:141, SolrXmlConfig
  loadNodeConfig:265, SolrDispatchFilter
  createCoreContainer:233, SolrDispatchFilter
  init:167, SolrDispatchFilter
  

3. loadNodeConfig方法

• 实现细节：
  • 使用SolrResourceLoader加载solr.xml
  • 调用SolrXmlConfig.fromSolrHome解析配置
  • 每个私有属性对应solr.xml中的字段

四、关键组件解析

1. CoreContainer：

   • 核心容器，管理所有Solr Core
   • 对应solr.xml配置

2. NodeConfig：

   • 封装solr.xml配置信息
   • 每个字段对应配置文件中的设置

3. SolrResourceLoader：

   • 资源加载器
   • 负责加载solr.xml等配置文件

五、总结

1. 启动流程：

   • Jetty容器初始化
   • WebAppContext配置
   • Handler链构建
   • ServletHandler初始化
   • SolrDispatchFilter初始化
   • CoreContainer创建

2. 关键点：

   • Jetty的Handler链机制
   • SolrDispatchFilter作为入口Filter
   • CoreContainer的核心容器作用
   • 配置文件的加载解析过程

3. 调试技巧：

   • 关注doStart()方法调用链
   • 跟踪ServletHandler.initialize()
   • 观察SolrDispatchFilter.init()过程