如何在ASP.NET Core应用内确定Kestrel绑定的随机端口？

嘿，这个需求我之前刚好处理过，给你几个实用的方法，能让你在应用内部轻松拿到随机绑定的端口：

方法1：通过IWebHost.ServerFeatures直接获取（WebHost模式） #

这是最直接的方式，在Program类的Main方法里启动主机后，通过IServerAddressesFeature特性获取绑定地址，再解析出端口：

public static void Main(string[] args)
{
    var host = BuildWebHost(args);
    // 先启动主机，否则端口还未完成绑定
    host.Start();
    
    // 获取服务器绑定的地址集合
    var serverAddresses = host.ServerFeatures.Get<IServerAddressesFeature>()?.Addresses;
    if (serverAddresses != null)
    {
        foreach (var address in serverAddresses)
        {
            var uri = new Uri(address);
            Console.WriteLine($"服务已启动，绑定端口：{uri.Port}");
        }
    }
    
    host.WaitForShutdown();
}

public static IWebHost BuildWebHost(string[] args) =>
    WebHost.CreateDefaultBuilder(args)
        .UseStartup<Startup>()
        .UseUrls("http://*:0") // 启用随机端口绑定
        .Build();

关键点：必须在调用host.Start()之后再获取端口，因为只有启动完成后服务器才会完成随机端口的绑定。

方法2：在Startup.Configure中获取 #

如果需要在请求处理逻辑中用到端口，可以在Configure方法里通过IApplicationBuilder的ServerFeatures属性获取：

public void Configure(IApplicationBuilder app, IWebHostEnvironment env)
{
    var serverAddresses = app.ServerFeatures.Get<IServerAddressesFeature>();
    if (serverAddresses != null && serverAddresses.Addresses.Any())
    {
        // 取第一个绑定地址的端口（如果有多个地址可以遍历处理）
        var port = new Uri(serverAddresses.Addresses.First()).Port;
        
        app.Run(async (context) =>
        {
            await context.Response.WriteAsync($"当前服务的随机绑定端口是：{port}");
        });
    }
}

这种方式适合需要给前端返回端口信息，或者在中间件中使用端口的场景。

方法3：ASP.NET Core 3.0+通用主机模式（Host.CreateDefaultBuilder） #

如果你用的是通用主机模板（现在大部分新项目默认用这个），方法类似，只是获取IServerAddressesFeature的方式稍有不同：

public static async Task Main(string[] args)
{
    var host = Host.CreateDefaultBuilder(args)
        .ConfigureWebHostDefaults(webBuilder =>
        {
            webBuilder.UseStartup<Startup>()
                      .UseUrls("http://*:0"); // 随机端口
        })
        .Build();

    await host.StartAsync();

    // 从服务容器中获取IServerAddressesFeature
    var serverAddresses = host.Services.GetRequiredService<IServerAddressesFeature>();
    foreach (var address in serverAddresses.Addresses)
    {
        var uri = new Uri(address);
        Console.WriteLine($"服务运行地址：{address}，端口：{uri.Port}");
    }

    await host.WaitForShutdownAsync();
}

额外注意事项 #

• 如果你的服务同时绑定了多个协议（比如HTTP和HTTPS），Addresses集合会包含所有绑定地址，记得遍历处理每个地址的端口。
• 不要在主机启动前尝试获取端口，此时服务器还未完成端口分配，会拿到空值。

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