Spring多上下文经GraalVM打包后启动失败：ServletWebServerFactory缺失

问题原因 #

GraalVM原生镜像构建时会执行激进的代码优化，若子上下文的Web自动配置未被正确识别，或相关Bean未被标记为需保留的对象，就会出现ServletWebServerFactory缺失的错误。Jar包运行时Spring的动态机制能自动触发配置，但原生镜像需要显式的元数据或Bean定义才能保留必要组件。

解决方案 #

1. 显式声明ServletWebServerFactory Bean #

在ApiApp和WebApp的配置类中手动添加Web服务器工厂Bean，确保原生镜像构建时能检测到该组件：

import org.springframework.boot.web.embedded.tomcat.TomcatServletWebServerFactory
import org.springframework.boot.web.servlet.server.ServletWebServerFactory
import org.springframework.context.annotation.Bean

// ApiApp配置类
@Configuration
class ApiAppConfig {
    @Bean
    fun apiServletWebServerFactory(): ServletWebServerFactory {
        val tomcat = TomcatServletWebServerFactory()
        tomcat.setPort(8081)
        return tomcat
    }
}

// WebApp配置类
@Configuration
class WebAppConfig {
    @Bean
    fun webServletWebServerFactory(): ServletWebServerFactory {
        val tomcat = TomcatServletWebServerFactory()
        tomcat.setPort(8080)
        return tomcat
    }
}

2. 调整多上下文启动方式 #

将链式调用改为显式的父子上下文启动，避免原生镜像构建时元数据丢失：

fun main(args: Array<String>) {
    // 启动父上下文
    val parentContext = SpringApplicationBuilder(MainContextConfiguration::class.java)
        .web(WebApplicationType.NONE)
        .run(*args)
    
    // 启动API子上下文
    SpringApplicationBuilder(ApiApp::class.java)
        .web(WebApplicationType.SERVLET)
        .parent(parentContext)
        .run(*args)
    
    // 启动Web子上下文
    SpringApplicationBuilder(WebApp::class.java)
        .web(WebApplicationType.SERVLET)
        .parent(parentContext)
        .run(*args)
}

3. 确保原生镜像构建依赖与元数据正确 #

• 确认已引入spring-boot-starter-native依赖，版本与Spring Boot版本匹配：

<!-- Maven示例 -->
<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-native</artifactId>
</dependency>

• 构建时添加-Dspring.aot.enabled=true参数，利用Spring Boot的自动元数据生成功能，确保所有必要的Bean和类被纳入原生镜像。

4. 验证依赖完整性 #

检查项目是否包含Servlet Web服务器依赖（如spring-boot-starter-tomcat），若使用spring-boot-starter-web则已默认包含，无需额外添加，但需确保未在构建时排除该依赖。

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