Spring Boot部署Tomcat8启动失败：SAMLCustomBootstrap空指针异常

在Tomcat 8上部署Spring Boot应用时出现启动失败，核心错误为SAMLCustomBootstrap类初始化时抛出NullPointerException，引发BeanCreationException。具体报错日志如下：

Caused by: org.springframework.beans.factory.BeanCreationException: Error creating bean with name 'SAMLCustomBootstrap' defined in file [/usr/share/tomcat8-uphp/webapps/appeals-grievances/WEB-INF/classes/com/ag/config/SAMLCustomBootstrap.class]: Invocation of init method failed; nested exception is java.lang.NullPointerException
    at org.springframework.beans.factory.support.AbstractAutowireCapableBeanFactory.initializeBean(AbstractAutowireCapableBeanFactory.java:1628)
    at org.springframework.beans.factory.support.AbstractAutowireCapableBeanFactory.doCreateBean(AbstractAutowireCapableBeanFactory.java:555)
    at org.springframework.beans.factory.support.AbstractAutowireCapableBeanFactory.createBean(AbstractAutowireCapableBeanFactory.java:483)
    at org.springframework.beans.factory.support.AbstractBeanFactory$1.getObject(AbstractBeanFactory.java:306)
    at org.springframework.beans.factory.support.DefaultSingletonBeanRegistry.getSingleton(DefaultSingletonBeanRegistry.java:230)
    at org.springframework.beans.factory.support.AbstractBeanFactory.doGetBean(AbstractBeanFactory.java:302)
    at org.springframework.beans.factory.support.AbstractBeanFactory.getBean(AbstractBeanFactory.java:197)
    at org.springframework.beans.factory.support.DefaultListableBeanFactory.preInstantiateSingletons(DefaultListableBeanFactory.java:761)
    at org.springframework.context.support.AbstractApplicationContext.finishBeanFactoryInitialization(AbstractApplicationContext.java:866)
    at org.springframework.context.support.AbstractApplicationContext.refresh(AbstractApplicationContext.java:542)
    at org.springframework.boot.context.embedded.EmbeddedWebApplicationContext.refresh(EmbeddedWebApplicationContext.java:122)
    at org.springframework.boot.SpringApplication.refresh(SpringApplication.java:737)
    at org.springframework.boot.SpringApplication.refreshContext(SpringApplication.java:370)
    at org.springframework.boot.SpringApplication.run(SpringApplication.java:314)
    at org.springframework.boot.web.support.SpringBootServletInitializer.run(SpringBootServletInitializer.java:151)
    at org.springframework.boot.web.support.SpringBootServletInitializer.createRootApplicationContext(SpringBootServletInitializer.java:131)
    at org.springframework.boot.web.support.SpringBootServletInitializer.onStartup(SpringBootServletInitializer.java:86)
    at org.springframework.web.SpringServletContainerInitializer.onStartup(SpringServletContainerInitializer.java:169)
    at org.apache.catalina.core.StandardContext.startInternal(StandardContext.java:5225)
    at org.apache.catalina.util.LifecycleBase.start(LifecycleBase.java:150)
    ... 10 more
Caused by: java.lang.NullPointerException
    at com.beaconhcs.ag.config.SAMLCustomBootstrap.afterPropertiesSet(SAMLCustomBootstrap.java:18)
    at org.springframework.beans.factory.support.AbstractAutowireCapableBeanFactory.invokeInitMethods(AbstractAutowireCapableBeanFactory.java:1687)
    at org.springframework.beans.factory.support.AbstractAutowireCapableBeanFactory.initializeBean(AbstractAutowireCapableBeanFactory.java:1624)
    ... 29 more

01-Aug-2024 04:26:36.162 SEVERE [localhost-startStop-1] org.apache.catalina.startup.HostConfig.deployWAR Error deploying web application archive [/usr/share/tomcat8-uphp/webapps/appeals-grievances.war]
java.lang.IllegalStateException: ContainerBase.addChild: start: org.apache.catalina.LifecycleException: Failed to start component [StandardEngine[Catalina].StandardHost[localhost].StandardContext[/appeals-grievances]]
    at org.apache.catalina.core.ContainerBase.addChildInternal(ContainerBase.java:758)
    at org.apache.catalina.core.ContainerBase.addChild(ContainerBase.java:730)
    at org.apache.catalina.core.StandardHost.addChild(StandardHost.java:734)
    at org.apache.catalina.startup.HostConfig.deployWAR(HostConfig.java:980)
    at org.apache.catalina.startup.HostConfig$DeployWar.run(HostConfig.java:1851)
    at java.util.concurrent.Executors$RunnableAdapter.call(Executors.java:511)
    at java.util.concurrent.FutureTask.run(FutureTask.java:266)
    at java.util.concurrent.ThreadPoolExecutor.runWorker(ThreadPoolExecutor.java:1149)
    at java.util.concurrent.ThreadPoolExecutor$Worker.run(ThreadPoolExecutor.java:624)
    at java.lang.Thread.run(Thread.java:750)

解决方案 #

• 定位NPE根源：打开SAMLCustomBootstrap.java第18行代码，检查是否调用了未初始化对象的方法、访问了null属性。比如该类中通过@Autowired注入的依赖是否未被Spring容器正确加载，导致对象为null。
• 调整Bean加载顺序：如果SAMLCustomBootstrap依赖其他Bean，确保这些依赖Bean在它之前完成初始化。可通过@DependsOn注解指定依赖的Bean名称，强制Spring先创建依赖Bean。
• 校验配置完整性：检查应用配置文件（如application.properties/application.yml）中是否缺失SAML相关配置项，比如用@Value注入的属性是否存在有效值，避免因配置缺失导致属性为null。
• 检查环境资源：确认Tomcat运行环境中，SAML初始化所需的资源（如密钥文件、元数据文件）路径是否正确，文件是否存在且有读取权限，防止因资源加载失败导致null对象。
• 添加非空校验：在afterPropertiesSet方法中对所有可能为null的对象添加非空判断，或设置默认值，避免直接调用方法触发NPE。

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