Spring Batch应用Linux服务器启动报错：缺失ServletWebServerFactory Bean

我来帮你排查这个问题——这个报错本质是Spring Boot误判了你的应用类型：它试图启动Web容器（比如Tomcat），但你的Spring Batch是非Web批处理应用，根本不需要Web环境。本地运行正常但服务器出问题，大概率是启动配置、依赖或者环境配置的差异导致的，下面给你具体解决办法：

核心报错拆解 #

先明确报错的本质：

Unable to start web server; nested exception is org.springframework.context.ApplicationContextException: Unable to start ServletWebServerApplicationContext due to missing ServletWebServerFactory bean

这个信息说明Spring Boot进入了Web应用启动流程，但找不到创建Web服务器的工厂类——而这正是因为你的批处理应用不需要这个组件。

具体解决办法 #

1. 启动命令直接指定非Web环境（最快验证方案） #

本地运行时可能IDE自动帮你处理了应用类型，或者你隐式指定了参数，但服务器启动时没加。直接在启动命令里添加参数强制指定非Web环境：

• 如果是Jar包运行：

java -jar your-batch-application.jar --spring.main.web-application-type=none

• 如果是指定类路径运行：

java -cp your-classpath-root com.your.company.BatchApplicationMain --spring.main.web-application-type=none

也可以用JVM参数的方式：

java -Dspring.main.web-application-type=none -cp your-classpath-root com.your.company.BatchApplicationMain

2. 依赖层面排除Web相关组件（长期解决方案） #

检查你的项目依赖配置，是不是不小心引入了spring-boot-starter-web这类Web依赖？如果是，要么直接移除，要么明确指定应用类型：

• Maven（pom.xml）：
  如果误加了Web依赖，优先移除；如果需要保留某些Web组件但不需要启动Web容器，添加如下配置：

<properties>
    <spring.main.web-application-type>none</spring.main.web-application-type>
</properties>

• Gradle（build.gradle）：

spring.main.webApplicationType = "none"

3. 配置文件统一指定应用类型 #

如果本地配置文件里已经加了非Web环境配置，但部署到服务器时没同步，把这个配置加到服务器的application.properties或application.yml里：

• application.properties：

spring.main.web-application-type=none

• application.yml：

spring:
  main:
    web-application-type: none

4. 检查打包方式（兜底验证） #

确保你用Spring Boot官方插件打包的是可执行Jar，避免依赖缺失：
Maven打包命令：

mvn clean package spring-boot:repackage

Gradle打包命令：

gradle clean bootJar

总结 #

最快的解决方式是在启动命令里添加--spring.main.web-application-type=none参数，适合快速验证；如果要彻底解决，建议在依赖或配置文件里明确指定非Web环境，避免后续部署再踩坑。

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