Fix the Missing EmbeddedServletContainerFactory Bean Error: Troubleshoot the Unable to Start EmbeddedWebApplicationContext Issue

In this guide, we'll discuss how to troubleshoot and fix the "Missing EmbeddedServletContainerFactory Bean" error which causes the "Unable to Start EmbeddedWebApplicationContext" issue in a Spring Boot application. By following the step-by-step solution provided in this document, you'll be able to resolve the issue and run your Spring Boot application without any errors.

Table of Contents


The "Unable to Start EmbeddedWebApplicationContext" issue is encountered when the Spring Boot application is unable to initialize the embedded servlet container. The common cause of this issue is the missing EmbeddedServletContainerFactory bean in the Spring Boot application context.

This error typically occurs in the following situations:

  1. When the application is missing the necessary dependencies for Spring Boot to automatically configure the embedded servlet container.
  2. When there's a misconfiguration in the application's or application.yml files.

Step-by-Step Solution

To fix the "Missing EmbeddedServletContainerFactory Bean" error and resolve the "Unable to Start EmbeddedWebApplicationContext" issue, follow these steps:

Step 1: Check Dependencies

Ensure that you have the necessary Spring Boot dependencies in your pom.xml or build.gradle file. For a typical web application, you should include the following dependency:




dependencies {
    implementation 'org.springframework.boot:spring-boot-starter-web'

If you're using Spring Boot with Reactive Web, include the following dependency instead:




dependencies {
    implementation 'org.springframework.boot:spring-boot-starter-webflux'

Step 2: Check Configuration Files

Check your or application.yml files for any misconfigurations regarding the embedded servlet container. Ensure that the server-related properties are correctly set. For example:



  port: 8080
    context-path: /myapp

Step 3: Verify Main Class

Ensure that your main class is annotated with @SpringBootApplication, which includes the @EnableAutoConfiguration annotation. This will enable Spring Boot to automatically configure the embedded servlet container.

import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;

public class MyApp {
    public static void main(String[] args) {, args);

After completing the above steps, your application should be able to start without any errors.


1. What does the EmbeddedServletContainerFactory bean do?

The EmbeddedServletContainerFactory bean is responsible for creating and configuring the embedded servlet container in a Spring Boot application. It is automatically configured by Spring Boot when the necessary dependencies are included in the project.

2. Can I use a different embedded servlet container?

Yes, Spring Boot supports multiple embedded servlet containers such as Tomcat, Jetty, and Undertow. You can switch between them by including the appropriate dependencies and excluding the default Tomcat dependency.

3. How can I customize the embedded servlet container?

You can customize the embedded servlet container by implementing a WebServerFactoryCustomizer bean in your application. This allows you to modify the server configuration, such as the port, context path, and SSL settings.

4. Can I disable the embedded servlet container?

Yes, you can disable the embedded servlet container by excluding the spring-boot-starter-web or spring-boot-starter-webflux dependency and including the spring-boot-starter dependency in your project.

5. How can I troubleshoot other Spring Boot application startup issues?

You can enable debug logging by adding the --debug flag when starting your application or by setting the debug property in your or application.yml files. This will provide more detailed logs during the application startup process.

Great! You’ve successfully signed up.

Welcome back! You've successfully signed in.

You've successfully subscribed to

Success! Check your email for magic link to sign-in.

Success! Your billing info has been updated.

Your billing was not updated.