[Spring Boot] SpringBootServletInitializer는 언제, 왜 필요한가? (WAR 배포와 web.xml의 차이)

🧩 개요

Spring Boot를 공부하면서 SpringBootServletInitializer라는 클래스를 접하게 됐다.
나는 전자정부프레임워크 프로젝트를 할 땐 web.xml을 설정하고 톰캣에 WAR을 배포하는 구조에 익숙했다.
그래서 Spring Boot에서는 web.xml이 없다는 게 생소했고,
대체 이 구조에서 “메인 메서드 역할”을 누가 해주는지,
WAR 배포 시에는 어떤 설정이 필요한지 개념이 다소 모호하게 느껴졌다.

이 글은 그런 궁금증을 정리한 일종의 회고이자,
SpringBootServletInitializer의 필요성과 작동 방식을 JAR vs WAR 배포 구조 차이 중심으로 정리한 것이다.

✅ Spring Boot는 왜 web.xml이 없을까?

전자정부프레임워크(MVC2 기반)에서는 톰캣 같은 WAS에 .war 파일을 배포하고
그 안의 web.xml에서 다음과 같은 걸 지정했다.

• 시작 서블릿 (DispatcherServlet 등)
• 초기 파라미터
• 인덱스 파일 (index.jsp 등)

<web-app>
  <servlet>
    <servlet-name>dispatcher</servlet-name>
    <servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class>
  </servlet>
</web-app>

 

 

💡 Spring Boot는 내장 톰캣을 포함하고 있어서, 서버 설정 자체를 코드로 처리하고 main() 함수가 애플리케이션의 시작점 역할을 하기 때문.

 

즉, 톰캣도, 서블릿 등록도 다 자동이다.

 

✅ 그런데 외부 WAS에 WAR을 배포할 때는?

문제는 Spring Boot를 WAR로 패키징해서 외부 톰캣에 배포할 경우다.
이때는 더 이상 main()을 직접 실행할 수 없다.

외부 톰캣은 web.xml 또는 Servlet API를 통해 어떤 클래스가 애플리케이션을 시작할지 알아야 한다.
그래서 이때 필요한 것이 바로 👉 SpringBootServletInitializer

 

✅ SpringBootServletInitializer란?

 

외부 톰캣이 Spring Boot 애플리케이션을 부팅할 수 있도록
진입점을 연결해주는 브릿지 클래스

내장 톰캣이 없는 WAR 환경에서는
외부 톰캣이 web.xml의 Servlet을 참고해 진입점을 찾듯이,
Spring Boot에서는 SpringBootServletInitializer가 진입점 역할을 하게 된다.

 

@SpringBootApplication
class MyApplication : SpringBootServletInitializer() {
    override fun configure(application: SpringApplicationBuilder): SpringApplicationBuilder {
        return application.sources(MyApplication::class.java)
    }
}

 

✅ 언제 필요하고, 언제 필요 없는가?

배포 방식	톰캣 종류	필요 여부	설명
java -jar	내장 톰캣	❌ 필요 없음	main()이 직접 실행됨
.war 파일	외부 톰캣	✅ 필요함	WAS가 Spring을 인식할 수 있도록 초기화 클래스 필요

 

✅ 내장 톰캣 vs 외부 톰캣, 뭐가 다른가?

항목	내장 톰캣	외부 톰캣
배포	jar 실행	war 복사
설정 위치	main() 내부 설정	server.xml, webapps 폴더 등
Spring 실행 방식	직접 실행	WAS가 실행, Spring은 부름받는 구조
SpringBootServletInitializer 필요 여부	❌	✅

 

✅ 그럼 jar로 만들면 무조건 내장 톰캣이 포함되나?

 

대부분의 경우, YES.

 

• Spring Boot에서 spring-boot-starter-web만 의존하면 자동으로 내장 톰캣이 포함됨
• 다만, providedRuntime("...tomcat...")으로 설정하거나
• Jetty/Nett 서버로 교체하면 톰캣은 빠짐

dependencies {
    implementation("org.springframework.boot:spring-boot-starter-web") // 톰캣 포함
    // or
    // providedRuntime("org.springframework.boot:spring-boot-starter-tomcat") // WAR용
}

 

+ ⚙️ Gradle 설정 시 주의점

WAR 빌드를 하려면 build.gradle.kts에서 다음처럼 설정해야 한다:

plugins {
    id("war")
}

dependencies {
    providedRuntime("org.springframework.boot:spring-boot-starter-tomcat")
}

providedRuntime 설정을 해줘야 내장 톰캣을 JAR에 포함시키지 않게 된다.
WAR는 톰캣이 외부에 따로 존재하므로, 내장 톰캣은 빼줘야 한다.