내장 서버 — 스프링부트에 톰캣이 내장되어 있다는 게 무슨 뜻일까

[전통적 방식]
1. 톰캣 서버 설치 (버전 관리 필요)
2. 톰캣 설정 파일 수정 (server.xml 등)
3. WAR 파일 빌드
4. WAR를 톰캣의 webapps/ 디렉토리에 배포
5. 톰캣 재시작

[임베디드 방식]
1. JAR 파일 빌드 (톰캣 포함)
2. java -jar app.jar 실행

SpringApplication.run()
  └── createApplicationContext()
      └── ServletWebServerApplicationContext 생성
          └── onRefresh()
              └── createWebServer()
                  └── ServletWebServerFactory.getWebServer() 호출
                      └── TomcatServletWebServerFactory
                          └── Tomcat 인스턴스 생성
                              └── Connector 설정 (포트, 프로토콜)
                              └── Engine → Host → Context 설정
                              └── DispatcherServlet 등록
                              └── tomcat.start() 호출

// 스프링부트 내부 (개념적)
public class TomcatServletWebServerFactory implements ServletWebServerFactory {

    @Override
    public WebServer getWebServer(ServletContextInitializer... initializers) {
        Tomcat tomcat = new Tomcat();

        // Connector 설정 (HTTP 포트)
        Connector connector = new Connector("org.apache.coyote.http11.Http11NioProtocol");
        connector.setPort(this.port); // 기본 8080
        tomcat.setConnector(connector);

        // Context 설정
        Context context = tomcat.addContext("", System.getProperty("java.io.tmpdir"));

        // 서블릿 초기화 (DispatcherServlet 등록)
        for (ServletContextInitializer initializer : initializers) {
            initializer.onStartup(context.getServletContext());
        }

        tomcat.start();
        return new TomcatWebServer(tomcat);
    }
}

[요청 처리 흐름]
클라이언트 → Acceptor Thread (연결 수락)
           → Poller Thread (I/O 이벤트 감지, NIO)
           → Worker Thread Pool (실제 요청 처리)
              └── DispatcherServlet → Controller → Service → ...

server:
  port: 8080                          # 서버 포트
  servlet:
    context-path: /api                # 컨텍스트 패스

  tomcat:
    threads:
      max: 200                        # 최대 워커 스레드 수 (기본 200)
      min-spare: 10                   # 최소 유지 스레드 수 (기본 10)
    max-connections: 8192             # 최대 동시 연결 수 (기본 8192)
    accept-count: 100                 # 대기열 크기 (기본 100)
    connection-timeout: 20000         # 연결 타임아웃 (ms)
    keep-alive-timeout: 20000         # Keep-Alive 타임아웃 (ms)
    max-keep-alive-requests: 100      # Keep-Alive 요청 수 제한

[요청 처리 용량]
동시 처리 가능: max-connections (8192)
    └── 실제 처리: threads.max (200)
        └── 대기열: accept-count (100)
            └── 거부: Connection Refused

총 수용 가능 연결 = max-connections + accept-count

@Component
public class TomcatCustomizer implements WebServerFactoryCustomizer<TomcatServletWebServerFactory> {

    @Override
    public void customize(TomcatServletWebServerFactory factory) {
        factory.setPort(9090);

        factory.addConnectorCustomizers(connector -> {
            Http11NioProtocol protocol = (Http11NioProtocol) connector.getProtocolHandler();
            protocol.setMaxThreads(300);
            protocol.setMinSpareThreads(20);
            protocol.setConnectionTimeout(30000);

            // 압축 설정
            connector.setProperty("compression", "on");
            connector.setProperty("compressibleMimeType",
                "text/html,text/xml,text/plain,application/json");
            connector.setProperty("compressionMinSize", "1024");
        });
    }
}

server:
  port: 8443
  ssl:
    key-store: classpath:keystore.p12
    key-store-password: changeit
    key-store-type: PKCS12
    key-alias: myapp

@Configuration
public class HttpsConfig {

    @Bean
    public ServletWebServerFactory servletContainer() {
        TomcatServletWebServerFactory factory = new TomcatServletWebServerFactory();

        // 추가 HTTP 커넥터 (HTTPS는 application.yml에서 설정)
        Connector httpConnector = new Connector(TomcatServletWebServerFactory.DEFAULT_PROTOCOL);
        httpConnector.setPort(8080);
        factory.addAdditionalTomcatConnectors(httpConnector);

        return factory;
    }
}

<!-- pom.xml -->
<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-web</artifactId>
    <exclusions>
        <exclusion>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-tomcat</artifactId>
        </exclusion>
    </exclusions>
</dependency>
<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-undertow</artifactId>
</dependency>

// build.gradle
implementation('org.springframework.boot:spring-boot-starter-web') {
    exclude group: 'org.springframework.boot', module: 'spring-boot-starter-tomcat'
}
implementation 'org.springframework.boot:spring-boot-starter-undertow'

server:
  shutdown: graceful                    # 우아한 종료 활성화

spring:
  lifecycle:
    timeout-per-shutdown-phase: 30s     # 종료 대기 시간

// 종료 이벤트 감지
@Component
public class ShutdownListener {

    @EventListener(ContextClosedEvent.class)
    public void onShutdown() {
        log.info("애플리케이션 종료 중... 리소스 정리");
    }
}