当前位置：首页 > 文章列表 > 文章 > java教程 > Spring Boot 8080 端口冲突解决方法

Spring Boot 8080 端口冲突解决方法

2025-09-06 17:47:21 0浏览收藏

**Spring Boot 8080 端口冲突解决方法：快速解决Gradle项目启动难题** 本文针对 Spring Boot 开发者在使用 Gradle 构建项目时，经常遇到的 "Web server failed to start. Port 8080 was already in use." 端口冲突问题，提供详细的解决方案。你是否也曾因 8080 端口被占用而导致 Spring Boot 应用启动失败？本文将一步步教你如何精准定位占用 8080 端口的进程，并提供多种解决方法：你可以选择安全地终止占用端口的进程，也可以灵活地配置 Spring Boot 应用使用其他可用端口，如 8081。通过修改 application.properties 或 application.yml 文件，轻松更改 Spring Boot 应用的默认端口设置。无论你是新手还是经验丰富的开发者，都能通过本文快速解决端口冲突问题，确保 Spring Boot 应用顺利启动并运行。

解决 Spring Boot Gradle 项目启动时端口 8080 冲突问题

本文旨在帮助开发者解决 Spring Boot Gradle 项目启动时遇到的端口 8080 冲突问题。通过本文，你将学会如何识别占用 8080 端口的进程，并采取相应措施，例如终止该进程或配置 Spring Boot 应用使用其他端口，从而成功启动你的 Spring Boot 应用。

当你在使用 Gradle 构建的 Spring Boot 项目中运行 ./gradlew bootRun 命令时，如果遇到类似 "Web server failed to start. Port 8080 was already in use." 的错误信息，这通常意味着你的电脑上已经有其他进程占用了 8080 端口，导致 Spring Boot 应用无法启动。以下是解决此问题的步骤：

1. 查找占用 8080 端口的进程

首先，我们需要确定哪个进程占用了 8080 端口。不同的操作系统有不同的命令可以用来查找：

Windows:
在命令提示符或 PowerShell 中运行以下命令：
```
netstat -aon | findstr 8080
```
该命令会列出所有使用 8080 端口的连接，并显示对应的进程 ID (PID)。
Unix/Linux/Mac:
在终端中运行以下命令：
```
lsof -i :8080
```
该命令会列出占用 8080 端口的进程信息，包括进程的 PID。

2. 终止占用 8080 端口的进程

找到占用 8080 端口的进程 ID 后，你可以选择终止该进程。

Windows:
可以使用 taskkill 命令，例如：
```
taskkill /F /PID <PID>
```
将替换为实际的进程 ID。也可以使用任务管理器，在“详细信息”选项卡中找到对应的 PID，然后结束该进程。
Unix/Linux/Mac:
可以使用 kill 命令，例如：
```
kill <PID>
```
将替换为实际的进程 ID。如果进程无法正常终止，可以使用 kill -9 强制终止。

3. 配置 Spring Boot 应用使用其他端口

如果你不想终止占用 8080 端口的进程，或者你希望 Spring Boot 应用始终使用不同的端口，你可以通过配置 application.properties 或 application.yml 文件来更改 Spring Boot 应用的端口。

在 application.properties 文件中添加以下配置：

server.port=8081

或者在 application.yml 文件中添加以下配置：

server:
  port: 8081

将 8081 替换为你想要使用的端口号。

示例：application.properties

spring.application.name=my-spring-boot-app
server.port=8081

注意事项:

确保选择一个未被其他应用程序占用的端口。
如果你的 Spring Boot 应用使用了安全协议 (HTTPS)，还需要配置 server.ssl.key-store 和 server.ssl.key-store-password 等相关属性。

总结

端口冲突是开发过程中常见的问题。通过本文提供的步骤，你可以轻松地找到并解决 Spring Boot Gradle 项目启动时遇到的端口 8080 冲突问题。记住，在终止进程之前，请确认该进程是否可以安全终止，以免影响其他应用程序的正常运行。如果不想终止现有进程，可以灵活地配置 Spring Boot 应用使用不同的端口。

好了，本文到此结束，带大家了解了《Spring Boot 8080 端口冲突解决方法》，希望本文对你有所帮助！关注golang学习网公众号，给大家分享更多文章知识！