啟動 TCP Server 前需確認埠號可用。TcpListener.Start() 直接綁定失敗會拋例外,但**例外處理成本高、錯誤訊息不直觀**。最佳做法:**啟動前主動偵測**,埠被佔用時給予友善提示或自動尋找下一個可用埠。
System.Net.NetworkInformation.IPGlobalProperties 提供作業系統級 TCP/UDP 監聽端點快照,**無需嘗試綁定即可知曉埠佔用狀態**。
using System;
using System.Net;
using System.Net.NetworkInformation;
using System.Net.Sockets;
namespace PortDetector
{
public static class PortUtility
{
///
/// 檢查本機 TCP 埠是否正在被監聽
///
/// 埠號 (1-65535)
/// true=已被監聽, false=可用
public static bool IsTcpPortListening(int port)
{
if (port < 1 || port > 65535)
throw new ArgumentOutOfRangeException(nameof(port), "埠號範圍 1-65535");
IPGlobalProperties ipProps = IPGlobalProperties.GetIPGlobalProperties();
IPEndPoint[] listeners = ipProps.GetActiveTcpListeners();
foreach (IPEndPoint ep in listeners)
{
if (ep.Port == port)
return true;
}
return false;
}
///
/// 尋找指定範圍內第一個可用 TCP 埠
///
public static int FindAvailableTcpPort(int startPort = 10000, int endPort = 65535)
{
var usedPorts = new HashSet();
foreach (var ep in IPGlobalProperties.GetIPGlobalProperties().GetActiveTcpListeners())
usedPorts.Add(ep.Port);
for (int p = startPort; p <= endPort; p++)
if (!usedPorts.Contains(p))
return p;
throw new InvalidOperationException($"範圍 {startPort}-{endPort} 無可用埠");
}
}
// ===== 驗證範例 =====
class Program
{
static void Main()
{
const int testPort = 8080;
Console.WriteLine($"檢查埠 {testPort}:{ (PortUtility.IsTcpPortListening(testPort) ? "已佔用" : "可用") }");
// 實際佔用埠:啟動 HttpListener
using (var listener = new HttpListener())
{
listener.Prefixes.Add($"https://+:{testPort}/");
listener.Start();
Console.WriteLine($"HttpListener 已在埠 {testPort} 啟動");
Console.WriteLine($"再次檢查:{ (PortUtility.IsTcpPortListening(testPort) ? "已佔用" : "可用") }");
Console.WriteLine("按任意鍵停止 Listener...");
Console.ReadKey();
}
Console.WriteLine($"Listener 關閉後:{ (PortUtility.IsTcpPortListening(testPort) ? "已佔用" : "可用") }");
// 尋找可用埠示範
int freePort = PortUtility.FindAvailableTcpPort(9000, 9100);
Console.WriteLine($"9000-9100 首個可用埠:{freePort}");
}
}
}
public static bool IsPortListening(int port, bool checkTcp = true, bool checkUdp = true)
{
var props = IPGlobalProperties.GetIPGlobalProperties();
if (checkTcp)
foreach (var ep in props.GetActiveTcpListeners())
if (ep.Port == port) return true;
if (checkUdp)
foreach (var ep in props.GetActiveUdpListeners())
if (ep.Port == port) return true;
return false;
}
NET_ADMIN)。try-catch 綁定失敗。GetActiveTcpListeners 回傳包含 IPv4 (::ffff:0:0/96) 與 IPv6 端點,Port 屬性統一可比較。Established 狀態的連線**不在**此清單中,若需查看所有連線用 GetActiveTcpConnections()。| 方法 | 優點 | 缺點 |
|---|---|---|
IPGlobalProperties | 非侵入式、無競態風險、可列舉所有埠 | 需系統權限、快照可能過期 |
TcpListener.Start() + Catch | 真實驗證可綁定性 | 例外成本高、佔用埠才知道 |
P/Invoke GetExtendedTcpTable | 可取得 Process ID、狀態 | 平台相容複雜、需 P/Invoke |
嘗試 Socket.Bind | 輕量、可設定 ExclusiveAddressUse | 仍需例外處理、僅單埠測試 |
IPGlobalProperties.GetActiveTcpListeners() 是 C# **偵測埠佔用的標準非侵入式 API**。搭配 FindAvailableTcpPort 自動尋找可用埠,配合啟動時 try-catch 兜底,即可構建健壯的 TCP Server 啟動邏輯。