1. 报错现象
当你点击运行 SpringBoot 的启动类 Application.java 时,控制台出现如下错误堆栈:
*************************** APPLICATION FAILED TO START ***************************
Description: Web server failed to start. Port 8080 was already in use.
Action: Identify and stop the process that's listening on port 8080 or configure this application to listen on another port.
2. 解决方法一:找出并杀死占用端口的进程(推荐)
这是最彻底的解决方法。我们需要找到是哪个程序占用了 8080 端口,然后干掉它。
🟢 Windows 系统解决方案
第一步:打开 CMD 窗口 按下 Win + R,输入 cmd,回车。
第二步:查找占用端口的 PID 输入以下命令:
netstat -ano | findstr 8080
你会看到类似这样的输出:
TCP 0.0.0.0:8080 0.0.0.0:0 LISTENING 12345
TCP [::]:8080 [::]:0 LISTENING 12345
注意最右边的数字 12345,这就是占用端口的 进程 ID (PID)。
第三步:杀死进程 输入以下命令(将 12345 换成你刚才查到的实际 PID):
taskkill /F /PID 12345
提示'成功:已终止 PID 为 12345 的进程'后,重新启动你的 SpringBoot 项目即可!
🟢 Mac / Linux 系统解决方案
第一步:打开终端 Terminal
第二步:查找并杀死进程 有两种方式:
方式 B(一行命令搞定):
# 直接根据端口号杀进程
fuser -k 8080/tcp
方式 A(分步执行):
# 1. 查找 PID
lsof -i :8080
# 输出示例:
# COMMAND PID USER FD TYPE DEVICE SIZE/OFF NODE NAME
# java 9876 root 45u IPv6 0x12345678 0t0 TCP *:http-alt (LISTEN)
# 2. 杀死进程 (将 9876 换成你的 PID)
kill -9 9876
3. 解决方法二:修改 SpringBoot 项目端口
如果你不想杀进程(比如 8080 被其他重要服务占用了),可以修改当前项目的启动端口。
情况 A:使用的是 application.properties
在 src/main/resources/application.properties 文件中添加:
# 将端口修改为 8081
server.port=8081


