IDEA 启动项目报错：Address localhost:8080 is already in use

在使用 IntelliJ IDEA 启动 Spring Boot 或 SSM 项目时，很多人会遇到以下报错信息：

SSM项目报错信息如下：

Address localhost:8080 is already in use

SpringBoot项目报错信息如下：

Web server failed to start. Port 8080 was already in use

这类错误非常常见，本质原因是：端口 8080 已经被其他程序占用，Spring Boot 默认的内嵌 Tomcat 无法启动。

一、常见报错场景

1. Spring Boot 项目启动时报错
   • 默认端口 8080 已被其他程序占用
2. Tomcat 独立启动时报错
   • 系统已有一个 Tomcat 在运行
3. IDEA 多次运行同一个项目
   • 上一次项目没有关闭，新的实例又占用 8080
4. 其他程序占用了 8080
   • 例如：Nginx、IIS、Node.js、其他 Java 应用

二、错误原因

• 端口冲突：同一时间，一个端口只能被一个进程使用。
• 未正确关闭的进程：上一次程序崩溃或被强制关闭，但进程还在运行。
• 多个应用都配置了 8080：导致冲突。

三、解决方法

方法 1：重启电脑

电脑重启后所有端口占用都会释放，再启动项目就不会出现端口冲突的现象了。

方法 2：更换端口号（不推荐）

SpringBoot项目在 application.properties 或 application.yml 中修改端口：

application.properties

server.port=8081

application.yml

server:
    port: 8081

SSM项目修改外部 Tomcat 的端口号

方法 3：结束占用端口的进程

1. 查询端口占用：

   netstat -ano | findstr 8080

   输出示例：

   TCP    0.0.0.0:8080     0.0.0.0:0      LISTENING     30680

   其中 30680 是进程号 (PID)。

2. 结束进程：

   taskkill -pid 30680 -f

四、总结

当遇到 “Address localhost:8080 is already in use” 或 “Web server failed to start. Port 8080 was already in use” 报错时，不必慌张：

• 这是 端口被占用 引起的常见错误
• 解决方法主要有两种：换端口 或 释放端口

只要掌握了这套排查方法，就能快速解决端口冲突问题。