🎬 HoRain云小助手：个人主页

 🔥 个人专栏: 《Linux 系列教程》《c语言教程》

⛺️生活的理想，就是为了理想的生活!

---

⛳️ 推荐

前些天发现了一个超棒的服务器购买网站，性价比超高，大内存超划算！忍不住分享一下给大家。点击跳转到网站。

专栏介绍

专栏名称	专栏介绍
《C语言》	本专栏主要撰写C干货内容和编程技巧，让大家从底层了解C，把更多的知识由抽象到简单通俗易懂。
《网络协议》	本专栏主要是注重从底层来给大家一步步剖析网络协议的奥秘，一起解密网络协议在运行中协议的基本运行机制！
《docker容器精解篇》	全面深入解析 docker 容器，从基础到进阶，涵盖原理、操作、实践案例，助您精通 docker。
《linux系列》	本专栏主要撰写Linux干货内容，从基础到进阶，知识由抽象到简单通俗易懂，帮你从新手小白到扫地僧。
《python 系列》	本专栏着重撰写Python相关的干货内容与编程技巧，助力大家从底层去认识Python，将更多复杂的知识由抽象转化为简单易懂的内容。
《试题库》	本专栏主要是发布一些考试和练习题库（涵盖软考、HCIE、HRCE、CCNA等）

目录

⛳️ 推荐

专栏介绍

🔍 问题诊断流程

📝 详细解决方案

1. ​​检查日志获取详细错误信息​​

2. ​​解决端口冲突问题​​

3. ​​排查依赖冲突​​

4. ​​检查配置文件​​

5. ​​检查JDK和Spring Boot版本兼容性​​

6. ​​清理和重新构建项目​​

7. ​​检查系统资源​​

⚠️ 高级排查技巧

💡 预防措施

---

"Unable to start embedded Tomcat" 是 Spring Boot 应用启动时常见的错误，通常由端口冲突、依赖问题或配置错误引起。下面我将为你提供一套完整的排查和解决方案。

🔍 问题诊断流程

首先，你可以按照以下流程图系统性地排查问题，从最简单常见的原因开始检查：

flowchart TD
    A[启动报错<br>Unable to start embedded Tomcat] --> B[检查日志详情]
    B --> C{端口是否被占用？}
    C -- 是 --> D[更改端口或释放端口]
    C -- 否 --> E{依赖是否存在冲突？}
    E -- 是 --> F[清理依赖冲突]
    E -- 否 --> G{配置是否正确？}
    G -- 是 --> H{资源是否充足？}
    G -- 否 --> I[修正配置文件]
    H -- 不足 --> J[增加系统资源]
    H -- 充足 --> K[检查JDK版本兼容性]
    D --> L[重新启动应用]
    F --> L
    I --> L
    J --> L
    K --> L
    L --> M[问题解决]

📝 详细解决方案

1. ​​检查日志获取详细错误信息​​

启动应用时，控制台输出的日志是定位问题的第一手资料。关注 ERROR级别的日志信息，它们通常指明了失败的具体原因。

2. ​​解决端口冲突问题​​

这是最常见的原因。嵌入式Tomcat默认使用8080端口，如果该端口已被其他程序占用，启动就会失败。

​​解决方案：​​

• ​​检查端口占用情况​​：

  # Windows 系统：
  netstat -ano | findstr :8080
  # Linux/macOS 系统：
  lsof -i :8080

• ​​更改应用端口​​：

  在 application.properties中修改：

  server.port=8081

  或在 application.yml中修改：

  server:
    port: 8081

• ​​使用随机端口​​（适合开发环境）：

  server.port=0

3. ​​排查依赖冲突​​

项目中的依赖版本冲突是导致Tomcat启动失败的另一个常见原因。

​​解决方案：​​

• ​​检查依赖树​​：

  mvn dependency:tree

  通过此命令查看是否存在多个不同版本的Tomcat依赖或其他冲突。

• ​​排除冲突依赖​​：

  在 pom.xml中，排除冲突的依赖：

  <dependency>
      <groupId>某个组</groupId>
      <artifactId>某个artifact</artifactId>
      <exclusions>
          <exclusion>
              <groupId>冲突的组</groupId>
              <artifactId>冲突的artifact</artifactId>
          </exclusion>
      </exclusions>
  </dependency>

• ​​确保必要的依赖​​：确认 pom.xml中包含Spring Boot Web启动器。

  <dependency>
      <groupId>org.springframework.boot</groupId>
      <artifactId>spring-boot-starter-web</artifactId>
  </dependency>

4. ​​检查配置文件​​

application.properties或 application.yml中的错误配置可能导致Tomcat启动失败。

​​重点关注以下配置：​​

• ​​服务器端口​​：server.port

• ​​Tomcat最大线程数​​：server.tomcat.max-threads

• ​​HTTP超时设置​​：server.connection-timeout

• ​​SSL配置​​（如果使用HTTPS）

5. ​​检查JDK和Spring Boot版本兼容性​​

确保你使用的JDK版本与Spring Boot版本兼容。例如，Spring Boot 2.x通常需要JDK 8或11，而Spring Boot 3.x则需要JDK 17或更高版本。

6. ​​清理和重新构建项目​​

有时旧的编译文件或缓存可能导致问题。

# Maven 项目
mvn clean install

# Gradle 项目
gradle clean build

在IDE中，可以尝试清理项目并重启IDE。

7. ​​检查系统资源​​

确保系统有足够的内存和磁盘空间供Tomcat启动。如果资源不足，可能需要增加JVM堆内存：

java -Xmx512m -Xms256m -jar your-application.jar

⚠️ 高级排查技巧

如果上述方法仍不能解决问题，可以尝试以下高级技巧：

1. ​​启用调试模式​​：

   mvn spring-boot:run -DDEBUG

   或添加调试参数：

   logging.level.org.springframework.boot=DEBUG
   logging.level.org.apache.tomcat=DEBUG

2. ​​检查特定于Tomcat的配置​​：

   在 application.properties中调整Tomcat特定参数：

   # 增加Tomcat启动等待时间
   server.tomcat.background-processor-delay=30
   # 调整最大连接数
   server.tomcat.max-connections=200

💡 预防措施

为避免未来再次遇到此类问题，建议采取以下预防措施：

• ​​使用依赖管理工具​​：充分利用Maven或Gradle的依赖管理功能，避免手动引入可能冲突的依赖。

• ​​配置校验​​：在提交代码前，对配置文件进行校验。

• ​​持续集成​​：在CI/CD流程中加入构建和启动测试，及早发现问题。

希望这份指南能帮助你解决"Unable to start embedded Tomcat"错误。按照上述步骤系统性地排查，大多数情况下都能找到问题所在并成功解决。

❤️❤️❤️本人水平有限，如有纰漏，欢迎各位大佬评论批评指正！😄😄😄

💘💘💘如果觉得这篇文对你有帮助的话，也请给个点赞、收藏下吧，非常感谢!👍 👍 👍

🔥🔥🔥Stay Hungry Stay Foolish 道阻且长,行则将至,让我们一起加油吧！🌙🌙🌙