C#怎么检查端口是否被占用_C#如何管理网络连接状态【避坑】-C#.Net教程-PHP中文网

TcpClient连接探测仅能粗略判断端口连通性，可靠检测本机端口占用应使用IPGlobalProperties.GetActiveTcpListeners()，或直接尝试Socket.Bind并设置ExclusiveAddressUse=true。

c#怎么检查端口是否被占用_c#如何管理网络连接状态【避坑】

怎么用 `TcpClient` 快速探测端口是否被占用

直接用 TcpClient 尝试连接目标地址+端口，连得上 ≠ 端口空闲（可能是服务在监听），连不上也不一定被占（防火墙、权限、路由问题）。真正要判断“是否被本地进程监听”，得查本机监听状态。

实操建议：

仅用于粗略探活：构造 new TcpClient().Connect("127.0.0.1", 8080)，捕获 SocketException 中的错误码 10061（连接拒绝）通常说明没服务在监听；10060（连接超时）更可能是网络或防火墙拦截
别依赖 ConnectAsync 的成功与否下结论——有些服务（如 IIS Express）会接受连接但立即断开，导致误判为空闲
超时必须设短：client.ConnectAsync(host, port).Wait(500)，否则默认阻塞几秒，卡主线程

用 `IPGlobalProperties.GetActiveTcpListeners()` 查本地监听端口

这才是判断“端口是否被本机进程占用”的可靠方式。它返回所有当前处于 Listen 状态的本地终结点（IPEndPoint），不含远程连接或已建立的连接。

常见错误现象：查不到 Docker 容器或 WSL2 中监听的端口——因为它们不在 Windows 主机网络栈里，GetActiveTcpListeners 只看 Windows 自身协议栈。

实操建议：

代码片段：

var listeners = IPGlobalProperties.GetIPGlobalProperties().GetActiveTcpListeners();
bool isOccupied = listeners.Any(ep => ep.Port == 8080 && (ep.Address == IPAddress.Any || ep.Address == IPAddress.Loopback));

IPAddress.Any 表示监听所有网卡（0.0.0.0:8080），IPAddress.Loopback 是 127.0.0.1:8080，二者都需覆盖
注意：.NET Core 3.1+ 和 .NET 5+ 中该 API 仍可用，但 Linux/macOS 下行为受限（部分系统不暴露完整监听列表）

为什么 `netstat -ano` 比 C# API 更准，但不能直接在代码里调用

因为 netstat 调用的是系统底层接口（Windows 上是 GetExtendedTcpTable），能拿到 PID、进程名、连接状态等完整信息，而 C# 的 IPGlobalProperties 是其封装，做了简化和过滤。

"避开 C# 常见错误——空陷阱、异步陷阱、LINQ 陷阱及资源泄漏。"

下载

实操建议：

调试时优先用命令行：netstat -ano | findstr :8080，再用 tasklist /fi "pid eq 1234" 确认进程
若必须在程序中集成，可用 Process.Start("netstat", "-ano") 捕获输出，但要注意：
- 不同 Windows 版本输出格式略有差异（列对齐、空格数），正则解析容易崩
- 需要管理员权限才能看到其他用户 PID，普通用户运行可能漏掉某些监听项
不要试图用 netstat 结果反推“端口是否可用”——比如 LISTENING 状态只是说明有进程绑定了，不代表你能成功 bind（可能已被独占模式占用）

绑定端口前的终极检查：用 `Socket` 尝试 `Bind` 并设 `ExclusiveAddressUse`

最接近真实场景的验证方式——模拟你要做的操作：bind + listen。哪怕端口当前空闲，也可能因权限、IPv6/IPv4 冲突、SO_EXCLUSIVEADDRUSE 设置失败而无法真正使用。

实操建议：

关键参数必须显式设置：

var socket = new Socket(AddressFamily.InterNetwork, SocketType.Stream, ProtocolType.Tcp);
socket.ExclusiveAddressUse = true;
socket.Bind(new IPEndPoint(IPAddress.Any, 8080));
socket.Listen(1); // 成功即说明可绑定
socket.Close();