Spring Boot 3.0.0-M5原生镜像运行报错：无ServletWebServerFactory Bean

1. 验证AOT配置类是否正确注册Tomcat工厂 #

Spring Boot原生镜像依赖AOT提前生成配置元数据，可能TomcatServletWebServerFactory未被正确识别并注册到上下文：

• 检查AOT构建生成的配置类，确认org.springframework.boot.autoconfigure.web.servlet.ServletWebServerFactoryConfiguration.Tomcat相关代理类是否存在
• 确认spring-boot-starter-web依赖在AOT构建时被正确解析，排查是否因Spring Cloud Config远程配置加载，打乱了自动配置的执行顺序

2. 检查原生镜像初始化策略 #

日志中存在--initialize-at-run-time=io.netty参数，需确认Tomcat相关类是否被错误设置为运行时初始化：

• 查看完整的原生镜像构建参数，排查是否包含org.apache.catalina、org.springframework.boot.web.embedded.tomcat这类Tomcat核心包的运行时初始化配置
• 尝试添加--initialize-at-build-time=org.springframework.boot.web.embedded.tomcat,org.apache.catalina参数，确保Tomcat核心类在构建阶段完成初始化

3. 排查远程配置对Web服务器的影响 #

应用启动时优先加载了Config Server的配置，需确认远程配置是否干扰了Web服务器自动配置：

• 检查Config Server返回的application-prod相关配置，是否存在spring.main.web-application-type被设置为NONE或REACTIVE的情况
• 临时禁用Config Server配置加载（如启动时添加spring.config.import=optional:configserver:），测试原生镜像能否正常启动，排除远程配置的干扰

4. 确认版本兼容性问题 #

当前使用的Spring Cloud 2022.0.0-M5和Spring Boot 3.0.0-M5均为里程碑版本，可能存在原生镜像支持的兼容性bug：

• 确认Spring Cloud Config客户端的AOT支持是否完善，里程碑版本可能存在自动配置未适配原生镜像的情况
• 尝试升级到更高版本的里程碑或正式版（若已发布），修复已知的原生镜像兼容问题

5. 分析AOT构建日志的详细信息 #

除Tomcat类路径信息外，重点排查AOT构建过程中的警告或错误：

• 搜索日志中包含ServletWebServerFactory、Tomcat的条目，确认是否有类未注册、反射配置缺失的提示
• 检查生成的spring-aot-metadata.json文件，确认Tomcat相关Bean定义是否被正确记录

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