SpringBoot单元测试启动失败：如何解决@SpringBootTest加载ApplicationContext异常？

SpringBoot单元测试启动失败排查指南

使用SpringBoot的@SpringBootTest进行单元测试时，启动失败的情况时有发生。本文通过一个案例，分析@SpringBootTest启动失败的原因及解决方法。

问题：测试类无法启动，报错信息如下：

java.lang.IllegalStateException: Failed to load ApplicationContext ... ... Caused by: org.springframework.core.convert.ConverterNotFoundException: No converter found capable of converting from type [java.lang.String] to type [org.springframework.boot.autoconfigure.web.server.servletWebServerFactory$Servlet] ... ...

错误堆栈信息表明，创建名为tomcatServletWebServerFactory的Bean失败，根本原因是无法将字符串类型转换为org.springframework.boot.autoconfigure.web.server.ServletWebServerFactory$Servlet类型。这通常与application.yml或application.properties配置文件中的server.servlet配置项有关。

问题分析与解决方案：

配置文件片段如下：

server:   port: 80   servlet:     #context-path: /demo

server.servlet配置块中的context-path被注释。虽然注释context-path本身不会直接导致错误，但结合错误信息，SpringBoot可能在解析server.servlet配置时遇到问题。由于缺乏其他有效配置，导致类型转换失败。

解决方法：

最简单的解决方法是移除或取消注释server.servlet块：

修改配置文件为：

server:   port: 80   #servlet:     #context-path: /demo

或者直接删除servlet配置块。这样，SpringBoot将不再尝试解析该配置块，避免类型转换错误，从而解决启动失败的问题。

重要提示： 分享代码或配置时，请务必注意保护敏感信息，例如数据库密码等，避免将其公开。