springboot启动报错Unable to start embedded container

SpringBoot启动失败之Tomcat容器问题
原创 已于 2022-09-09 17:52:23 修改 · 7.1k 阅读 · 0 ·
CC 4.0 BY-SA版权
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
文章标签：

#a child container #springboot启动报错 #tomcat启动报错 #Unable to start embedded conta #A child container failed durin

于 2019-08-14 14:29:30 首次发布
本文解决了一个常见的SpringBoot应用启动失败的问题，详细分析了“Unable to start embedded container”错误的原因，并提供了解决方案，即检查并处理与JRE中servlet-api.jar包的冲突。

如果你的springboot在启动的时候报如下的错误：

Error starting ApplicationContext. To display the auto-configuration report re-run your application with 'debug' enabled.
2019-08-13 17:02:05.907 ERROR 8416 --- [  restartedMain] o.s.boot.SpringApplication               : Application startup failed

org.springframework.context.ApplicationContextException: Unable to start embedded container; nested exception is org.springframework.boot.context.embedded.EmbeddedServletContainerException: Unable to start embedded Tomcat
	at org.springframework.boot.context.embedded.EmbeddedWebApplicationContext.onRefresh(EmbeddedWebApplicationContext.java:137)
	at org.springframework.context.support.AbstractApplicationContext.refresh(AbstractApplicationContext.java:537)
	at org.springframework.boot.context.embedded.EmbeddedWebApplicationContext.refresh(EmbeddedWebApplicationContext.java:122)
	at org.springframework.boot.SpringApplication.refresh(SpringApplication.java:693)
	at org.springframework.boot.SpringApplication.refreshContext(SpringApplication.java:360)
	at org.springframework.boot.SpringApplication.run(SpringApplication.java:303)
	at org.springframework.boot.SpringApplication.run(SpringApplication.java:1118)
	at org.springframework.boot.SpringApplication.run(SpringApplication.java:1107)
	at com.hzsun.Application.main(Application.java:26)
	at sun.reflect.NativeMethodAccessorImpl.invoke0(Native Method)
	at sun.reflect.NativeMethodAccessorImpl.invoke(NativeMethodAccessorImpl.java:62)
	at sun.reflect.DelegatingMethodAccessorImpl.invoke(DelegatingMethodAccessorImpl.java:43)
	at java.lang.reflect.Method.invoke(Method.java:497)
	at org.springframework.boot.devtools.restart.RestartLauncher.run(RestartLauncher.java:49)
Caused by: org.springframework.boot.context.embedded.EmbeddedServletContainerException: Unable to start embedded Tomcat
	at org.springframework.boot.context.embedded.tomcat.TomcatEmbeddedServletContainer.initialize(TomcatEmbeddedServletContainer.java:123)
	at org.springframework.boot.context.embedded.tomcat.TomcatEmbeddedServletContainer.<init>(TomcatEmbeddedServletContainer.java:84)
	at org.springframework.boot.context.embedded.tomcat.TomcatEmbeddedServletContainerFactory.getTomcatEmbeddedServletContainer(TomcatEmbeddedServletContainerFactory.java:554)
	at org.springframework.boot.context.embedded.tomcat.TomcatEmbeddedServletContainerFactory.getEmbeddedServletContainer(TomcatEmbeddedServletContainerFactory.java:179)
	at org.springframework.boot.context.embedded.EmbeddedWebApplicationContext.createEmbeddedServletContainer(EmbeddedWebApplicationContext.java:164)
	at org.springframework.boot.context.embedded.EmbeddedWebApplicationContext.onRefresh(EmbeddedWebApplicationContext.java:134)
	... 13 common frames omitted
Caused by: org.apache.catalina.LifecycleException: Failed to start component [StandardServer[-1]]
	at org.apache.catalina.util.LifecycleBase.start(LifecycleBase.java:167)
	at org.apache.catalina.startup.Tomcat.start(Tomcat.java:367)
	at org.springframework.boot.context.embedded.tomcat.TomcatEmbeddedServletContainer.initialize(TomcatEmbeddedServletContainer.java:99)
	... 18 common frames omitted
Caused by: org.apache.catalina.LifecycleException: Failed to start component [StandardService[Tomcat]]
	at org.apache.catalina.util.LifecycleBase.start(LifecycleBase.java:167)
	at org.apache.catalina.core.StandardServer.startInternal(StandardServer.java:793)
	at org.apache.catalina.util.LifecycleBase.start(LifecycleBase.java:150)
	... 20 common frames omitted
Caused by: org.apache.catalina.LifecycleException: Failed to start component [StandardEngine[Tomcat]]
	at org.apache.catalina.util.LifecycleBase.start(LifecycleBase.java:167)
	at org.apache.catalina.core.StandardService.startInternal(StandardService.java:422)
	at org.apache.catalina.util.LifecycleBase.start(LifecycleBase.java:150)
	... 22 common frames omitted
Caused by: org.apache.catalina.LifecycleException: A child container failed during start
	at org.apache.catalina.core.ContainerBase.startInternal(ContainerBase.java:947)
	at org.apache.catalina.core.StandardEngine.startInternal(StandardEngine.java:262)
	at org.apache.catalina.util.LifecycleBase.start(LifecycleBase.java:150)
	... 24 common frames omitted

总结起来主要有2点错误：

1.springboot的错误： Unable to start embedded container

2.内嵌的tomcat报错：A child container failed during start

如果你折腾了很久，试了网上各种抄来抄去的解决方案，查了tomcat的环境变量，重新更了代码和仓库，项目编译无任错误，也查了jetty可以替换，但是项目启动依然会报这个错的话......那么请看下面的解决办法；

解决办法：

检查一下项目的正在使用到的jdk，是否引入的jre里面有servlet-api.jar包，如果有那么恭喜你，问题就是这里了，springboot内嵌的tomcat有servlet-api的功能，跟jre里的servlet-api是冲突的哟，要么删除jre下面那个jar包，要么在项目pom.xml文件里面重新声明tomcat并将其servl-api.jar排除，问题就解决了！

Spring Cloud | Unable to start EmbeddedWebApplicationContext due to missing EmbeddedServletContainer
AI时代光年
12-26 4112
今天在用main方法启动spring cloud项目的时候，报如下错误：org.springframework.context.ApplicationContextException: Unable to start embedded container; nested exception is org.springframework.context.ApplicationContextExcept
(已解决)Unable to start embedded container/Unable to start embedded Tomcat
sky892012的博客
03-03 1580
学习springboot，比着教学视频做helloworld的例子，视频里三下五除二就完事了，结果到我这里，死活成功不了，网上有说jar冲突的，有说配置不完整的、配置有错的，但是对于一个小白来说，自己按照他们的步骤去解决太难了，也许他们思路是清晰的，但是他们表述的太笼统了，困扰了两天，终于找到了正确答案，是java的问题，jre的lib下的ext里有个servlet-api.jar文件，跟idea...
spring boot 报错 Unable to start embedded container;
fhhffchffy的专栏
12-22 6万+
想做个rest风格的控制器，简单例子：   @RestController @RequestMapping("/user") public class UserController { @RequestMapping("/{id}") public User view(@PathVariable("id") Long id){ User user = new User
spring报错Unable to start embedded container
weixin_43355618的博客
08-24 1069
新导入spring代码时报错 org.springframework.context.ApplicationContextException: Unable to start embedded container; nested exception is org.springframework.beans.factory.BeanCreationException: Error creating bean with name 'tomcatEmbeddedServletContainerFactory' d
解决“Unable to start embedded Tomcat“错误的完整指南
pleaseprintf的博客
08-13 1万+
在使用Spring Boot开发应用程序时，有时可能会遇到"Unable to start embedded Tomcat"的错误，这可能是由多种原因引起的。本文将详细介绍这个错误的常见原因以及解决方法，帮助你快速解决问题并顺利启动应用程序。通过本文，你已经了解了如何解决"Unable to start embedded Tomcat"错误，这些方法涵盖了多种可能的原因和解决方案。在解决问题时，务必根据错误信息和情况选择合适的方法。
4_7.springboot2.x嵌入式servlet容器自动配置原理
含江君
09-28 826
概述 Spring Boot对所支持的Servlet Web服务器实现做了建模抽象: Servlet容器类型 WebServer模型接口 WebServer工厂实现类 Tomcat TomcatWebServer TomcatServletWebServerFactory Jetty JettyWebServer Jett...
Unable to start embedded container
01-07 847
org.springframework.context.ApplicationContextException: Unable to start embedded container; nested exception is org.springframework.context.ApplicationContextException: Unable to start EmbeddedWebApp
spring-boot服务启动报: Unable to start embedded container
热门推荐
不积跬步 无以至千里
03-25 7万+
初次接触spring-boot + spring-cloud构建微服务项目,配置好项目后并选择启动类启动时报如下错误：[main] ERROR org.springframework.boot.SpringApplication - Application startup failedorg.springframework.context.ApplicationContextException: ...
关于解决搭建Eureka出现的Unable to start embedded Tomcat；无法启动嵌入式tomcat异常
m0_47250414的博客
08-14 1770
今天在搭建Eureka的时候，死活都跑不起来！一直提示 Unable to start web server; nested exception is org.springframework.boot.web.server.WebServerException: Unable to start embedded Tomcat；无法启动嵌入式tomcat； pom如下： <?xml version="1.0" encoding="UTF-8"?> <project xmlns="http:/
org.springframework.context.ApplicationContextException: Unable to start embedded container; nested exception is org.springframework.boot.context.embedded.EmbeddedServletContainerException: Unable to start embedded Tomcat
07-09
在 Spring Boot 应用中，当出现 `org.springframework.context.ApplicationContextException: Unable to start embedded container` 错误时，通常意味着应用在初始化嵌入式 Web 容器（如 Tomcat、Jetty 或 Undertow...
Unable to start embedded container; nested exception is org.springframework.boot.context.embedded.EmbeddedServletContainerException: Unable to start embedded Tomcat
06-09
这个问题可能是由于Tomcat服务启动失败所导致的。你可以尝试以下几个步骤来解决它： 1. 检查你的应用程序的端口是否被其他应用程序占用了，如果是，则需要修改应用程序的端口号。 2. 检查你的应用程序的配置文件...
SpringBoot 启动报错：Unable to start embedded
qq_26245263的博客
11-01 6575
启动springboot的时候报错，信息大概如下内容 org.springframework.context.ApplicationContextException: Unable to start embedded container; nested exception is org.springframework.boot.context.embedded.EmbeddedServletCo
org.springframework.context.ApplicationContextException: Unable to start embedded container;异常解决
DGH2430284817的博客
02-11 9544
在使用springboot的时候出现异常： org.springframework.context.ApplicationContextException: Unable to start embedded container; nested exception is java.lang.NoSuchMethodError: org.apache.tomcat.util.scan.Standar...
启动springboot项目报错Unable to start embedded container
mqingo的博客
12-19 1982
后端技术: mave,springbootDataJpa,Springboot,Log4j,Spring,Hibernate,Netty,JWT,jpush,Jetty / tomcat[与tomcat相比,更加轻量级],httpclient等 报错信息如下:   看了下pom.xml,使用到了jetty. &lt;?xml version="1.0" encoding="UTF-8...
org.springframework.context.ApplicationContextException: Unable to start embedded container； nested
sclarkca56的博客
09-08 1409
org.springframework.context.ApplicationContextException: Unable to start embedded container; nested exception is org.springframework.boot.context.embedded.EmbeddedServletContainerException: Unable to start embedded Tomcat SpringBoot 项目刚创建，一运行发现报错，报错内容如下：
SpringBoot报错Unable to start embedded container; nested exception is java.lang.NoSuchMethodError
南山有谷堆
02-24 7730
SpringBoot启动报错如下：Unable to start embedded container; nested exception is java.lang.NoSuchMethodError: org.apache.tomcat.util.scan.StandardJarScanner.setJarScanFilter(Lorg/apache/tomcat/JarScanFilter;经...
SpringBoot启动报错" Unable to start embedded container; nested exception is org.springframework.beans.fa
LinFord1995的博客
09-15 1万+
SpringBoot启动报如下异常:Error starting ApplicationContext. To display the auto-configuration report re-run your application with 'debug' enabled. 2017-09-15 14:08:02.979 [restartedMain] ERROR org.springframe
spring boot 报错 Unable to start embedded container;
flsmgf的专栏
03-15 2687
想做个rest风格的控制器，简单例子： [html] view plain copy@RestController  @RequestMapping("/user")  public class UserController {        @RequestMapping("/{id}")        public User view(@PathVariable("id") Long id){...
通过1panel环境运行一直报错：Unable to start embedded Tomcat
最新发布
08-16
<think>我们正在处理用户在1Panel环境中启动嵌入式Tomcat失败的问题，报错信息为"Unable to start embedded Tomcat"。尽管用户提供的引用[1]是关于Java Swing界面中添加按钮的代码，但我们可以忽略它，因为用户已经明确表示希望解决Tomcat启动问题。 在1Panel环境中，嵌入式Tomcat无法启动可能由多种原因引起，包括端口冲突、资源不足、配置错误、权限问题或依赖缺失等。我们将逐步排查这些可能的原因。 以下是解决步骤： ### 步骤1: 检查端口冲突 嵌入式Tomcat默认使用8080端口（HTTP）和8443端口（HTTPS）。如果这些端口已被其他进程占用，Tomcat将无法启动。 - **查看端口占用情况**： ```bash netstat -tuln | grep -E '8080|8443' ``` 如果发现端口被占用，可以停止占用端口的进程，或者修改Tomcat的配置文件，更改端口号。 - **修改Tomcat端口**： 在Spring Boot应用中，可以在`application.properties`（或`application.yml`）中修改端口： ```properties server.port=8081 # 修改为其他可用端口 ``` ### 步骤2: 检查内存和资源限制 在Docker容器中运行的应用可能受到内存限制。如果内存不足，Tomcat可能无法启动。 - **查看容器资源限制**： 在1Panel中，进入应用的管理界面，查看容器的资源分配（如内存、CPU）。确保分配了足够的内存（至少512MB，具体取决于应用需求）。 - **调整资源限制**： 如果资源不足，可以在1Panel中调整该容器的资源限制。 ### 步骤3: 检查日志文件 日志是定位问题的关键。查看应用日志，特别是启动时的错误信息。 - **在1Panel中查看日志**： 1. 进入1Panel的「应用管理」。 2. 找到对应的应用，点击「日志」按钮，查看实时日志。 - **常见日志错误及解决**： - **端口已占用**：如前所述，修改端口。 - **权限不足**：确保Tomcat有权限写入工作目录（如`/tmp`）和日志目录。可以在Docker启动命令中添加用户权限或修改目录权限： ```bash chmod -R 777 /path/to/tomcat/directory # 谨慎使用，仅用于测试环境 ``` 或者在Dockerfile中指定用户： ```Dockerfile USER root ``` - **数据库连接失败**：检查数据库配置（如URL、用户名、密码）是否正确，数据库服务是否可达。 - **类加载错误或依赖缺失**：检查应用依赖是否完整，尤其是`spring-boot-starter-web`。可以使用Maven或Gradle重新构建项目。 ### 步骤4: 检查嵌入式Tomcat版本与依赖 如果项目中使用的Spring Boot版本与嵌入式Tomcat版本不兼容，可能导致启动失败。 - **检查依赖**： 在项目的`pom.xml`（或`build.gradle`）中，确保以下依赖正确： ```xml <dependencies> <dependency> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-starter-web</artifactId> </dependency> </dependencies> ``` - **解决版本冲突**： 使用`mvn dependency:tree`（Maven）或`gradle dependencies`（Gradle）查看依赖树，排除冲突的依赖。例如： ```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-tomcat</artifactId> <version>${spring.boot.version}</version> <!-- 指定与Spring Boot兼容的版本 --> </dependency> ``` ### 步骤5: 检查Java环境 确保容器内的Java版本与项目要求的版本一致。例如，Spring Boot 2.x通常需要Java 8或11，而Spring Boot 3.x需要Java 17+。 - **查看容器内Java版本**： 在1Panel中进入该容器的终端，运行： ```bash java -version ``` - **调整Java版本**： 如果版本不匹配，需要在Dockerfile中指定正确的Java基础镜像。例如： ```Dockerfile FROM openjdk:17 # 使用Java 17 ``` ### 步骤6: 检查安全组和防火墙 虽然Tomcat启动失败通常与内部配置有关，但有时安全组或防火墙会阻止容器间的通信（如数据库连接），导致启动失败。 - **检查1Panel的防火墙规则**： 在1Panel的「安全」->「防火墙」中，确保放行了应用所需的端口（包括数据库端口，如3306）。 ### 总结 按照以上步骤排查，通常可以解决嵌入式Tomcat启动失败的问题。重点检查端口冲突、资源限制、日志错误和依赖兼容性。如果问题仍然存在，请提供具体的错误日志，以便进一步分析。 §§相关问题§§ 1. 如何查看1Panel中容器的实时日志？ 2. 在Docker容器中如何修改Java应用的内存设置？ 3. Spring Boot应用如何配置多环境配置文件？</think>### 解决 1Panel 环境中嵌入式 Tomcat 启动失败问题（报错 "Unable to start embedded Tomcat"） 在 1Panel 环境中启动嵌入式 Tomcat 失败通常由 **端口冲突、资源限制、配置错误或依赖缺失** 引起。以下是系统化的排查和解决步骤： --- #### 步骤 1: 检查端口冲突（最常见原因） 嵌入式 Tomcat 默认使用 `8080` 端口，若端口被占用会导致启动失败。 - **查看端口占用**： ```bash lsof -i :8080 # 检查 8080 端口占用 netstat -tuln | grep 8080 ``` - **解决方案**： 1. **终止占用进程**：`kill -9 <PID>`（替换 `<PID>` 为占用端口的进程 ID） 2. **修改 Tomcat 端口**（推荐）： - 在应用配置文件（如 `application.properties`）中添加： ```properties server.port=8081 # 改为其他空闲端口 ``` - 在 1Panel 的「应用管理」中修改容器端口映射（如图）： ```bash ports: - "8081:8081" # 主机端口:容器端口 ``` --- #### 步骤 2: 检查资源限制 Docker 容器的资源限制可能导致 Tomcat 无法启动。 - **查看容器资源状态**： ```bash docker stats <container_name> # 检查 CPU/内存使用率 ``` - **解决方案**： 1. 在 1Panel 的「容器管理」中： - 增加内存限制（至少 `512MB`） - 提高 CPU 配额（如 `0.5` 核以上） 2. 检查 JVM 内存设置： - 在启动命令中添加 JVM 参数： ```bash java -Xms256m -Xmx512m -jar your_app.jar ``` --- #### 步骤 3: 检查配置文件和依赖 错误配置或依赖缺失会阻止 Tomcat 初始化。 - **关键排查点**： 1. **应用配置文件**： - 检查 `application.properties` 或 `application.yml` 中的数据库连接、SSL 证书路径等。 - 示例错误：`SSL certificate path not found` 2. **依赖冲突**： - 检查 `pom.xml` 中的依赖版本冲突（如 `spring-boot-starter-tomcat` 与其他 Servlet 容器冲突）。 - 使用命令检测： ```bash mvn dependency:tree | grep tomcat ``` 3. **文件权限**： - 确保 Tomcat 工作目录（如 `/tmp/tomcat.*`）有写入权限： ```bash chmod -R 777 /tmp # 临时解决方案，生产环境需细化权限 ``` --- #### 步骤 4: 分析日志定位具体错误 通过日志获取精确错误信息： 1. 在 1Panel 中查看日志： - 进入「应用管理」→ 选择应用 → 点击「日志」按钮 2. 通过命令行查看： ```bash docker logs <container_id> | grep -i "tomcat\|error" ``` 3. **常见错误及解决**： - **端口绑定失败**：`Address already in use` → 参考步骤 1 - **内存不足**：`java.lang.OutOfMemoryError` → 参考步骤 2 - **类加载失败**：`ClassNotFoundException: org.apache.tomcat.*` → 重新构建项目依赖 --- #### 步骤 5: 验证环境兼容性 确保环境与嵌入式 Tomcat 兼容： - **Java 版本要求**： - Spring Boot 2.x → Java 8+ - Spring Boot 3.x → Java 17+ - **Tomcat 版本验证**： ```bash java -jar your_app.jar --version | grep Tomcat ``` - **解决方案**： 1. 在 Dockerfile 中指定正确 Java 版本： ```Dockerfile FROM openjdk:17 # 使用 Java 17 基础镜像 ``` 2. 更新依赖（`pom.xml`）： ```xml <properties> <tomcat.version>10.1.20</tomcat.version> <!-- 指定 Tomcat 版本 --> </properties> ``` --- #### 步骤 6: 重新部署应用 完成上述调整后： 1. 在 1Panel 中「重建」应用容器 2. 或手动执行： ```bash docker-compose down && docker-compose up -d --build ``` --- ### 总结流程图 ```mermaid graph TD A[启动失败 'Unable to start embedded Tomcat'] --> B{检查端口冲突} B -- 是 --> C[修改端口或终止进程] B -- 否 --> D{检查资源限制} D -- 是 --> E[增加内存/CPU] D -- 否 --> F{检查配置文件} F -- 错误 --> G[修正配置路径/依赖] F -- 正常 --> H{查看日志} H --> I[根据日志修复具体错误] I --> J[验证环境兼容性] J --> K[成功启动] ``` 通过以上步骤，90% 的嵌入式 Tomcat 启动问题可解决。若问题持续，请提供具体日志片段以便进一步分析。
评论 1
成就一亿技术人!
拼手气红包6.0元
还能输入1000个字符
 
红包 添加红包
表情包 插入表情
表情包 代码片
 条评论被折叠 查看
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包

打赏作者

cgv3

你的鼓励将是我创作的最大动力

¥1 ¥2 ¥4 ¥6 ¥10 ¥20
扫码支付：¥1
获取中
扫码支付

您的余额不足，请更换扫码支付或充值

打赏作者

实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值