Azure Pipelines绑定localhost运行集成测试端口占用如何解决？

问题根因 #

System.AggregateException : One or more errors occurred. (Failed to bind to address http://127.0.0.1:49159: address already in use.)

该报错不是Azure Pipelines不支持localhost绑定，核心原因是硬编码固定端口的逻辑不适配共享运行环境：Azure Pipelines的公共运行代理为多用户共享，可能存在其他进程已经占用了你指定的端口，即使更换多个端口也有可能命中已占用端口。

可行解决方案 #

方案1：使用Kestrel动态端口分配（最推荐） #

不要硬编码端口，让Kestrel自动分配空闲端口，启动后再获取实际绑定的端口传递给测试请求进程，代码修改如下：

var builder = new WebHostBuilder()
                // 移除硬编码的UseUrls配置
                .UseKestrel()
                .UseContentRoot(Directory.GetCurrentDirectory())
                .UseIISIntegration()
                .Configure(app =>
                {
                    app.Run(handler);
                })
                .Build();

builder.Start();
// 获取实际绑定的端口
var serverAddresses = builder.ServerFeatures.Get<Microsoft.AspNetCore.Hosting.Server.Features.IServerAddressesFeature>();
var address = serverAddresses.Addresses.First();
var port = new Uri(address).Port;
// 后续将port传递给发送HTTP请求的进程使用即可

方案2：提前检测端口可用性 #

如果必须使用固定端口，启动服务前先检测目标端口是否被占用：

public static bool IsPortAvailable(int port)
{
    try
    {
        using var tcpListener = new System.Net.Sockets.TcpListener(System.Net.IPAddress.Loopback, port);
        tcpListener.Start();
        tcpListener.Stop();
        return true;
    }
    catch (System.Net.Sockets.SocketException)
    {
        return false;
    }
}

调用上述检测逻辑遍历端口，直到找到可用端口再启动服务即可。

方案3：使用内存测试方案规避端口绑定 #

如果是ASP.NET Core应用的集成测试，可以使用官方Microsoft.AspNetCore.Mvc.Testing库的WebApplicationFactory，该方案不需要实际绑定网络端口，所有请求走内存传输，完全不会出现端口冲突问题，且执行效率更高，更适配CI环境。

注意事项 #

• 不要把硬编码固定端口作为CI环境的长期方案，极易出现偶发冲突
• 不要绑定除127.0.0.1/localhost之外的地址，避免触发代理的权限限制

内容的提问来源于stack exchange，提问作者TomPallister