Software⏱️ 3 min read📅 2026-06-03

How to Fix: Spring Boot: Unable to start EmbeddedWebApplicationContext due to missing EmbeddedServletContainerFactory bean

Missing EmbeddedServletContainerFactory bean in Spring Boot application.

Quick Answer: Ensure you have the correct dependency for EmbeddedServletContainerFactory in your pom.xml file. Use 'spring-boot-starter-web' instead of 'spring-boot-starter-test'.

📋 Table of Contents

  1. 🔍 Why This Happens
  2. ✅ Best Solutions to Fix It
  3. 💡 Conclusion

The error 'Unable to start EmbeddedWebApplicationContext due to missing EmbeddedServletContainerFactory bean' occurs when the Spring Boot application is unable to create an embedded servlet container, which is required for web applications. This issue affects developers who are new to Spring and are following the official guides from the Spring website.

This error can be frustrating because it prevents the application from starting properly and makes it difficult to test or deploy the application. The solution involves identifying the root cause of the issue and applying one of the primary fix methods.

🔍 Why This Happens

  • The first main reason why this error happens is that the EmbeddedServletContainerFactory bean is not being created due to a missing configuration. This can occur when the developer forgets to include the necessary dependencies in the project's pom.xml file or fails to configure the embedded servlet container correctly.
  • Another alternative reason for this issue is that there may be a conflict between different versions of Spring and its dependencies, causing the EmbeddedServletContainerFactory bean to fail creation. In such cases, updating the project's dependencies to the latest version can resolve the issue.

✅ Best Solutions to Fix It

Configuring the Embedded Servlet Container

  1. Step 1: Step 1: Ensure that the necessary dependencies are included in the project's pom.xml file. For a Spring Boot web application, this includes the spring-boot-starter-web dependency.
  2. Step 2: Step 2: Configure the embedded servlet container by adding the following configuration to the application.properties or application.yml file: spring.servlet.container.type=org.springframework.web.servlet.support.SpringServletContainer
  3. Step 3: Step 3: Verify that the EmbeddedServletContainerFactory bean is being created correctly by checking the Spring Boot logs for any errors related to the bean creation.

Updating Dependencies and Reconfiguring

  1. Step 1: Step 1: Update the project's dependencies to the latest version of Spring and its dependencies. This can be done by running the command 'mvn clean package' in the terminal.
  2. Step 2: Step 2: Reconfigure the embedded servlet container by adding the following configuration to the application.properties or application.yml file: spring.servlet.container.type=org.springframework.web.servlet.support.SpringServletContainer
  3. Step 3: Step 3: Verify that the EmbeddedServletContainerFactory bean is being created correctly by checking the Spring Boot logs for any errors related to the bean creation.

💡 Conclusion

By following one of the primary fix methods outlined above, developers should be able to resolve the 'Unable to start EmbeddedWebApplicationContext due to missing EmbeddedServletContainerFactory bean' error and get their Spring Boot application up and running properly.

Did this fix your problem?

If not, try searching for specific error codes.

🔍 Search Error Database

❓ Frequently Asked Questions

🛠️ Related Fixes

How to Fix: Pc crashes shortly after launching game (rainbow

Fix Pc crashes shortly after launching game (rainbow six siege). Compl

How to Fix: Installing an APK on a locked down phone

Installing an APK on a locked down phone: Try using a rooted device, e

How to Fix: New PC build- no signal and no clue

Fix New PC build- no signal and no clue. Complete troubleshooting guid