【Java异常：java.net.BindException: Address already in use: bind】

原创于 2025-09-01 17:28:02 发布 · 826 阅读

28 ·

CC 4.0 BY-SA版权

文章标签：

#java #.net #开发语言

Java 同时被 3 个专栏收录

16 篇文章

订阅专栏

经验分享

15 篇文章

订阅专栏

Bug

7 篇文章

订阅专栏

解决“java.net.BindException: Address already in use: bind”的指南

引言：令人头疼的“地址已被占用”

作为一名Java开发者，尤其是在进行网络编程或Web应用开发时，你可能经常会遇到一个令人沮丧的异常：

java.net.BindException: Address already in use: bind

这个异常通常在你启动一个服务器程序（如Tomcat、Spring Boot应用、Netty服务等）时抛出，它粗暴地打断了你的启动流程，并宣告失败。

别担心，这个错误很常见，而且几乎总是可以解决的。本文将带你深入理解这个异常背后的原因，并提供一套从简单到高级的排查和解决方法。

一、异常解析：为什么会出现？

简单来说，这个异常就像你想把车停进一个车位，却发现里面已经停了一辆车。在计算机网络中，这个“车位”就是 IP地址 + 端口号（IP:Port）的组合。

当一个网络应用程序启动时，它需要告诉操作系统：“请将我绑定到0.0.0.0:8080（举个例子）这个地址上，所有发往这个地址的数据包都交给我来处理。” 如果此时已经有另一个程序（可能是你之前启动未成功退出的同一个应用，也可能是其他完全不同的程序）已经占用了这个特定的“IP:Port”组合，操作系统就会拒绝这个绑定请求，并向JVM抛出一个 BindException。JVM再将其包装后抛给你的应用程序。

核心原因：你试图监听的网络端口，已经被其他进程占用了。

二、解决之道：一步一步排查和解决

遇到这个错误，不要慌张，请按照以下步骤进行排查。

第1步：确认端口冲突

首先，你需要确认是哪个端口被占用了。异常信息通常会告诉你，但有时也需要你去查看应用配置（比如Spring Boot的 server.port，Tomcat的 server.xml）。

假设我们确认是 8080 端口被占用。

第2步：找出“罪魁祸首”——是哪个进程占用了端口？

我们需要在命令行中使用网络诊断工具来找出占用端口的进程。

在Windows系统上：

打开命令提示符（CMD）或 PowerShell。
使用 netstat 命令查找特定端口的占用情况：
```
netstat -ano | findstr :8080
```
命令解释：
- netstat -ano：显示所有网络连接和监听端口，并显示对应的进程ID（PID）。
- findstr :8080：在结果中查找包含 :8080 的行。

命令会返回类似这样的结果：

TCP    0.0.0.0:8080           0.0.0.0:0              LISTENING       12345
TCP    [::]:8080              [::]:0                 LISTENING       12345

这里的关键是最后一列的 PID（进程ID），在这个例子中是 12345。
在这里插入图片描述

根据PID查找进程：
继续在CMD中输入：

tasklist | findstr 12345

你会看到占用8080端口的进程名称，例如：

java.exe                     12345 Console                    1     1,112 K

在这里插入图片描述

第3步：做出决策并解决问题

找到占用端口的进程后，你有以下几个选择：

方案A：终止占用端口的进程（最直接）

如果该进程是你自己的另一个实例（比如之前没关掉的Java应用）：直接杀掉它。
- Windows:
```
taskkill /F /PID 12345
```
  (/F 表示强制终止)
如果该进程是另一个重要服务（如MySQL、Nginx等）：请谨慎！ 不要随意杀掉你不了解的进程。你应该选择方案B。

方案B：更改你自己应用的端口（最安全）

这是更常见和安全的做法，尤其是开发环境中。

Spring Boot应用：
在 application.properties 中修改：
```
server.port=8090 # 换一个其他端口
```
或者在 application.yml 中：
```
server:
  port: 8090
```
Tomcat：
修改 conf/server.xml 文件中的 <Connector> 标签的 port 属性。
```
<Connector port="8090" protocol="HTTP/1.1" ... />
```

命令行启动Jar包时：

java -jar your-application.jar --server.port=8090

方案C：等待一段时间（特殊情况）

有时，特别是你刚刚终止了某个进程，操作系统可能不会立即释放该端口，会有一个 TIME_WAIT 状态。通常等待几十秒到一分钟再重启你的应用即可。

总结

java.net.BindException: Address already in use: bind 是一个常见的“好”错误，它保护了你的系统不会出现多个程序监听同一端口的混乱局面。

排查三步曲：

确认端口：看错误信息或应用配置。
查找进程：netstat -ano | findstr :端口号 (Win) 或 lsof -i :端口号 (Linux/Mac)。
做出决策：kill 掉旧进程或修改你自己应用的端口。

希望这篇指南能帮助到你！