安装Spring Boot时端口被占用启动失败怎么办

轻辰君_4225

轻辰君_4225

2026-08-07

374人浏览

原创

spring boot启动失败最常见的原因是端口被占用,尤其默认8080端口;可快速通过修改配置文件端口、启动时动态指定端口或查找并终止占用进程三种方式解决。

安装spring boot时端口被占用启动失败怎么办

Spring Boot 启动失败,最常见的原因就是端口被占用——尤其是默认的 8080 端口。别着急重启或重装,按这几步就能快速解决。

先确认是不是端口问题

启动时看到类似下面这些报错,基本可以锁定是端口冲突:

  • Failed to start component [Connector[HTTP/1.1-8080]]
  • Address already in use: bind
  • Web server failed to start. Port 8080 was already in use.

这些提示都指向同一个问题:你配置的端口(比如 8080)正被别的程序占着。

快速换一个端口(推荐新手)

最简单安全的办法,就是改配置,避开冲突端口:

Spring Boot 3.3.13
Spring Boot 3.3.13

Spring Boot下载页提供 3.3.13 官方源码 ZIP,并整理快速入门、项目创建、配置和自动配置说明。

下载
  • application.yml 中修改:
    server:
      port: 8081
    (注意缩进和冒号后空格)
  • application.properties 中写:
    server.port=8081
  • 或者不改文件,直接启动时指定:
    java -jar app.jar --server.port=8081

查出并干掉占用进程(治本)

如果你希望继续用 8080,或者想清理后台“幽灵进程”,就定位并结束它:

  • Windows:打开命令提示符,运行
    netstat -ano | findstr :8080
    找到最后一列的 PID,再执行
    taskkill /F /PID 1234(把 1234 换成实际 PID)
  • macOS/Linux:终端执行
    lsof -i :8080
    拿到 PID 后运行
    kill -9 1234

留意那些容易“偷偷占端口”的程序

除了另一个 Spring Boot 项目,以下这些也常默默霸占 8080:

  • IDEA 自带的临时服务(尤其多次 Run 后没彻底 Stop)
  • Navicat 的本地 Web 服务(某些版本启用时会开 HTTP 端口)
  • Docker 容器、VMware 虚拟机里的服务
  • Nginx、Apache、Tomcat 等 Web 服务器

关掉它们,或检查是否残留后台进程。

相关专题

更多
spring框架介绍
spring框架介绍

本专题整合了spring框架相关内容,想了解更多详细内容,请阅读专题下面的文章。

2025.08.06

2111

22

Java Spring Security 与认证授权
Java Spring Security 与认证授权

本专题系统讲解 Java Spring Security 框架在认证与授权中的应用,涵盖用户身份验证、权限控制、JWT与OAuth2实现、跨站请求伪造(CSRF)防护、会话管理与安全漏洞防范。通过实际项目案例,帮助学习者掌握如何 使用 Spring Security 实现高安全性认证与授权机制,提升 Web 应用的安全性与用户数据保护。

2026.01.26

397

25

NumPy性能优化版本更新与常见报错排查
NumPy性能优化版本更新与常见报错排查

本专题整理 NumPy 性能优化、版本更新与常见报错排查相关教程,覆盖向量化计算、广播性能、内存布局、NumPy 2.0 升级、版本兼容冲突、安装导入报错、dtype 溢出、矩阵运算异常和 broadcasting 报错修复,帮助读者系统掌握 NumPy 性能调优与问题定位方法。

2026.09.22

0

25

Vibeknow在线使用入口合集
Vibeknow在线使用入口合集

本专题汇总了Vibeknow在线创作视频的官方入口及网页版使用教程,涵盖PPT、PDF、Word等文档一键转讲解视频的核心操作,并整理了免费版水印规则与手机端浏览器访问指南,助你快速将知识内容视频化。

2026.09.21

20

20

NumPy随机数文件读写与dtype数据类型
NumPy随机数文件读写与dtype数据类型

本专题整理 NumPy 随机数、文件读写与 dtype 数据类型相关教程,覆盖 Generator/random、随机数种子、正态分布采样、npy/npz/CSV/TXT 保存读取、loadtxt/savetxt、memmap、大文件处理、astype 类型转换、结构化 dtype、整数溢出和精度丢失等场景。

2026.09.21

20

24

NumPy矩阵运算与线性代数计算
NumPy矩阵运算与线性代数计算

本专题整理 NumPy 矩阵运算与线性代数计算相关教程,覆盖矩阵乘法、dot 与 @ 运算符、逆矩阵、行列式、特征值与特征向量、SVD、线性方程组、欧氏距离、矩阵分解和大规模矩阵性能优化等内容,帮助读者掌握 np.linalg 与矩阵计算实战。

2026.09.21

0

20

NumPy广播机制数学运算与统计分析
NumPy广播机制数学运算与统计分析

本专题整理 NumPy 广播机制、数组数学运算与统计分析相关教程,覆盖广播规则、维度对齐、矩阵与数组加减除法、向量化计算、均值方差、分位数、中位数、直方图和 unique 频次统计等场景,帮助读者掌握 ndarray 高效计算与统计处理方法。

2026.09.21

0

17

NumPy数组创建索引切片与数据选择
NumPy数组创建索引切片与数据选择

本专题整理 NumPy 数组创建、索引、切片与数据选择相关教程,覆盖 np.array、zeros/ones、多维数组形状、基础切片、花式索引、布尔索引、条件筛选、视图与副本等常用场景,帮助读者系统掌握 ndarray 数据构造与高效提取方法。

2026.09.21

0

12

Aionclaw智能助手介绍
Aionclaw智能助手介绍

本专题汇总了AionClaw(AI龙虾助手)的功能介绍与在线使用入口。AionClaw是杭州趣猿人工智能有限公司推出的桌面级AI智能体,能直接在电脑上读写文件、运行脚本、操作浏览器,自动交付Word、PPT、Excel等成品。

2026.09.20

40

13

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
Spring Boot 官方快速入门指南
Spring Boot 官方快速入门指南

共0课时 | 0人学习

Spring Boot 官方参考文档
Spring Boot 官方参考文档

共0课时 | 0人学习

尚硅谷新版SpringBoot3教程
尚硅谷新版SpringBoot3教程

共0课时 | 0人学习