在编写基于C#的网络应用程序时，端口冲突是常见的异常来源。当启动TCP服务或者UDP接收端时，如果目标端口已经被其他进程占用，通常会抛出SocketException，提示地址已在使用中。要解决这个问题，最直接的方式就是在绑定端口之前主动检查端口占用状态，并据此给出友好的提示或者自动切换备用端口。本文将从多个角度探讨如何在C#中准确判断端口是否被占用，以及如何检查Socket的监听状态。
使用IPGlobalProperties获取系统端口占用信息
System.Net.NetworkInformation命名空间下的IPGlobalProperties类提供了获取本机网络全局信息的能力，其中就包括当前活动的TCP监听端口、UDP监听端口以及TCP连接状态。通过调用GetActiveTcpListeners和GetActiveUdpListeners方法，可以分别获得IPEndPoint数组，这几个数组实质上就是系统当前正在监听的Socket绑定列表。
下面这段代码演示了如何使用IPGlobalProperties来检测一个TCP端口是否已被占用。该方案将TCP监听、UDP监听以及已建立的TCP连接全部纳入检查范围，能够覆盖绝大多数端口占用场景。
using System.Net;
using System.Net.NetworkInformation;
using System.Net.Sockets;
public static class PortChecker
{
public static bool IsPortInUse(int port)
{
IPGlobalProperties properties = IPGlobalProperties.GetIPGlobalProperties();
// 检查TCP监听端口
IPEndPoint[] tcpListeners = properties.GetActiveTcpListeners();
foreach (IPEndPoint endpoint in tcpListeners)
{
if (endpoint.Port == port)
{
return true;
}
}
// 检查UDP监听端口
IPEndPoint[] udpListeners = properties.GetActiveUdpListeners();
foreach (IPEndPoint endpoint in udpListeners)
{
if (endpoint.Port == port)
{
return true;
}
}
// 检查已建立的TCP连接，包括TIME_WAIT等状态
TcpConnectionInformation[] connections = properties.GetActiveTcpConnections();
foreach (TcpConnectionInformation info in connections)
{
if (info.LocalEndPoint.Port == port)
{
return true;
}
}
return false;
}
}
这个方法有比较明显的优点：它直接查询系统的网络状态，不需要占用端口，也不会产生任何副作用。同时，它还能检测出并非由当前进程创建的监听端口，因此适用于检测机器上任何程序占用端口的情况。不过需要注意，GetActiveTcpListeners只返回IPv4的监听信息。如果程序需要同时检测IPv6地址下的监听端口，则需要额外处理，例如通过Socket枚举或者调用Windows API来获取更全面的信息。
还有一个细节值得关注：上述代码中同时检查了GetActiveTcpConnections，这是因为有些端口虽然没有处于监听状态，但仍然存在处于TIME_WAIT或者ESTABLISHED状态的TCP连接。若你只是判断端口能否用于新建监听，通常只需关心监听状态即可；但如果希望排查IP冲突类问题，将所有连接纳入检查会更稳妥。
通过绑定Socket试探端口可用性
在某些场景下，直接查询系统端口列表可能无法反映出动态绑定的细节，或者我们只关心当前进程是否有能力在该端口上建立一个监听。此时，可以尝试创建TcpListener并调用Start方法。如果端口已被占用，Start方法会抛出SocketException，其中的ErrorCode为10048，对应WSAEADDRINUSE。
利用这一原理，可以写一个更加贴近实际使用场景的检测方法。这个方法会短暂地占用目标端口，并在检测完成后立即释放。
using System.Net;
using System.Net.Sockets;
public static bool IsPortAvailable(int port)
{
TcpListener listener = null;
try
{
listener = new TcpListener(IPAddress.Any, port);
listener.Start();
return true;
}
catch (SocketException ex)
{
if (ex.ErrorCode == 10048)
{
return false;
}
throw;
}
finally
{
if (listener != null)
{
listener.Stop();
}
}
}
这种试探方式有一个潜在问题：它绑定的地址是IPAddress.Any，也就是IPv4中的任何本地地址。如果目标端口已经被某个进程仅绑定在特定的IP上，使用Any有可能发生冲突，但如果对方绑定的是特定IP，而你的Any绑定会覆盖所有IP，也可能导致冲突，具体取决于操作系统的绑定规则。通常来说，绑定Any会更严格，因此能大概率检测出冲突。
对于UDP端口，可以改用UdpClient进行类似探测。UdpClient绑定端口时也会检查占用情况，但UDP没有连接状态，因此检测逻辑相对简单。如果只需要检测UDP端口是否被占用，可以这样实现。
using System.Net;
using System.Net.Sockets;
public static bool IsUdpPortAvailable(int port)
{
UdpClient udpClient = null;
try
{
udpClient = new UdpClient(new IPEndPoint(IPAddress.Any, port));
return true;
}
catch (SocketException ex)
{
if (ex.ErrorCode == 10048)
{
return false;
}
throw;
}
finally
{
if (udpClient != null)
{
udpClient.Close();
}
}
}
需要注意的是，试探绑定法会创建一个真实的Socket，因此如果检测端口后没有及时释放，就会导致端口被短暂占用。在多线程或者高并发环境下，这种短暂的占用可能会引起其他线程误判。解决方法是尽量在程序启动早期执行检测，或者将检测与后续的Socket创建合并在一起，避免重复绑定。
调用netstat命令辅助检测
除了使用.NET类库，开发者还可以通过调用命令行工具netstat来获取端口状态。这种方法类似在命令行中手动执行netstat -ano，然后解析输出结果。虽然它不够优雅，但在某些没有权限访问网络命名空间的环境下，或者需要兼容旧版.NET Framework时，也可以作为一种辅助手段。
下面给出一个简单的调用netstat并通过正则表达式匹配端口信息的代码示例。该实现会从netstat的输出中查找目标端口所在行，如果找到则说明端口至少处于一种活动状态。
using System.Diagnostics;
using System.Text.RegularExpressions;
public static bool IsPortInUseByNetstat(int port)
{
Process process = new Process();
process.StartInfo.FileName = "netstat";
process.StartInfo.Arguments = "-ano";
process.StartInfo.UseShellExecute = false;
process.StartInfo.CreateNoWindow = true;
process.StartInfo.RedirectStandardOutput = true;
process.StartInfo.RedirectStandardError = true;
process.Start();
string output = process.StandardOutput.ReadToEnd();
process.WaitForExit();
// 匹配形如 " TCP 127.0.0.1:8080 0.0.0.0:0 LISTENING 1234" 的行
string pattern = string.Format(@"s+TCPs+[0-9.]+:{0}s+", port);
return Regex.IsMatch(output, pattern);
}
使用netstat的方案缺陷很明显：需要启动外部进程，性能不如直接调用API；而且netstat的输出格式在不同操作系统上可能存在差异，例如Windows与Linux的列位置不同，会降低代码的跨平台性。因此该方案更适合作为学习调试或临时辅助工具，而不建议作为生产环境的首选方案。
在对可靠性要求较高的场景下，更推荐将IPGlobalProperties查询与Socket绑定试探结合使用：先用IPGlobalProperties粗略排除大多数占用情况，再在真正创建Socket时捕获异常并做二次确认。这种两阶段策略既能保证性能，又能兼顾准确性。
检测Socket监听状态的特殊情况与注意事项
在检测端口时，有几个特殊情况经常导致误判。第一个是端口号0。在Socket编程中，端口0表示由操作系统动态分配一个空闲端口。如果你想检测端口0是否被占用，其实毫无意义，因为系统不会把0当作真实端口使用。因此，在调用检测函数之前，应当显式拒绝端口值小于1或大于65535的输入。
第二个特殊场景是IPv6地址。默认情况下，IPGlobalProperties的GetActiveTcpListeners只统计IPv4监听地址。如果程序需要支持IPv6，需要额外使用Socket的OSSupportsIPv6判断，或者通过查询系统路由表来补充。更简单的方式是使用TcpListener同时对IPv6和IPv4进行绑定测试，然后捕获异常。
第三个需要注意的是检测与Socket创建之间的竞态条件。即使检测结果显示端口可用，在你创建Socket的瞬间，另一个进程也可能恰好占用了该端口。因此，最稳妥的做法不是先检测再创建，而是直接尝试创建Socket，并在捕获到SocketException后决定是否重试。此时检测函数的作用更多是提供诊断信息，而不是作为绝对可靠的决策依据。
最后，还有权限问题。某些端口，特别是低于1024的端口，在Linux或Windows上可能需要管理员权限才能监听。即使端口没有被占用，如果当前进程权限不足，绑定也会失败。因此在跨平台开发中，不能只依赖端口占用检测结果来预判绑定是否成功，还必须结合权限异常。捕获到SocketException时，可以检查ErrorCode：10013表示权限拒绝，10048表示地址已占用，10049表示地址不可用。根据不同的错误码给出不同的提示，才能让用户的排错体验更好。
综上，C#判断端口是否被占用有多种实现方式。IPGlobalProperties查询法适合快速筛查，Socket绑定试探法适合在程序启动时确定端口是否真正可用，而netstat法虽然笨拙，但也可以作为补充工具。在实际开发中，最好将检测逻辑封装成一个工具类，并将端口值、协议类型作为参数暴露出来，方便在TCP/UDP、IPv4/IPv6之间灵活切换。