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將不再嘗試解析該配置塊，避免類型轉換錯誤，從而解決啟動失敗的問題。

重要提示： 分享代碼或配置時，請務必注意保護敏感信息，例如數據庫密碼等，避免將其公開。