Spring Boot启用JVM AOT编译时缺失ServletWebServerFactory Bean原因排查

1. Spring Cloud组件的AOT兼容性适配不足 #

Spring Cloud 2023.0.1（Leyton版本）虽适配了Spring Boot 3.3.x，但部分组件的AOT支持存在遗漏：

• 像Eureka、Config Client这类Cloud组件的自动配置类，在AOT编译的静态分析阶段，没有生成正确的字节码元数据，导致Spring Boot自动创建ServletWebServerFactory的逻辑未被触发。
• 部分Cloud组件的上下文修改逻辑、后置处理器，在AOT静态分析时未被正确识别，干扰了Web服务器工厂Bean的注册流程。

2. AOT静态分析的局限性 #

AOT编译依赖静态分析提前生成应用上下文元数据，动态注册Bean的逻辑若未做AOT适配会被忽略：

• 未启用AOT时，Spring可在运行时动态注册ServletWebServerFactory，但AOT模式下，这类动态逻辑必须通过@AotHint或RuntimeHints类提前声明，否则静态分析阶段无法识别，最终导致Bean缺失。
• 若项目有自定义Bean注册逻辑，或是Spring Security等依赖的动态Bean注册未适配AOT，都会引发该问题。

3. 依赖的AOT元数据不完整 #

包括Spring Security在内的部分依赖，可能未提供完整的AOT元数据：

• Spring Security的部分自动配置类在AOT编译时，未正确触发Web服务器相关Bean的依赖注册，导致上下文初始化时找不到ServletWebServerFactory。
• Maven依赖树中若存在未适配AOT的第三方库，其传递依赖可能破坏Spring Boot的AOT自动配置链。

4. 启动方式不符合官方AOT流程 #

直接通过-Dspring.aot.enabled=true启动的方式，跳过了关键的AOT元数据生成步骤：

• Spring Boot官方推荐的AOT流程是先通过Maven插件执行spring-boot:process-aot目标，生成AOT元数据和优化字节码，再启动应用。直接加JVM参数启用AOT，会导致自动配置所需的元数据缺失，进而无法正常注册Web服务器工厂Bean。

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