C#中Web API多实例启动的端口配置及实例级负载均衡疑问

一、如何指定非随机备用端口解决占用问题 #

不要用launchsettings.json配置多端口（它会让每个实例监听所有端口，反而加剧冲突），推荐两种可靠方式：

1. 启动脚本自动检测+命令行指定端口 #

写个简单的启动脚本，先检测默认端口是否被占用，占用则切换到预设的备用端口，以bash脚本为例：

# 预设默认端口和备用端口
DEFAULT_PORT=5000
BACKUP_PORT=5001

# 检测默认端口是否被监听
if lsof -Pi :$DEFAULT_PORT -sTCP:LISTEN -t >/dev/null ; then
    USE_PORT=$BACKUP_PORT
else
    USE_PORT=$DEFAULT_PORT
fi

# 启动API实例
dotnet YourApi.dll --urls=http://localhost:$USE_PORT

Windows下可以用bat脚本实现类似逻辑，这样Nginx只需预先配置5000和5001两个端口，无需随实例启停修改。

2. 程序内检测端口并切换备用地址 #

在appsettings.json中配置默认和备用端口：

{
  "Urls": "http://localhost:5000",
  "BackupUrls": "http://localhost:5001"
}

然后在Program.cs中添加端口占用检测逻辑，启动时自动切换：

var builder = WebApplication.CreateBuilder(args);

var defaultUrl = builder.Configuration["Urls"];
var backupUrl = builder.Configuration["BackupUrls"];

try
{
    builder.WebHost.UseUrls(defaultUrl);
    var app = builder.Build();
    // 常规中间件配置...
    app.Run();
}
catch (System.Net.Sockets.SocketException)
{
    // 捕获端口占用异常，切换到备用端口启动
    builder.WebHost.UseUrls(backupUrl);
    var app = builder.Build();
    // 常规中间件配置...
    app.Run();
}

二、同一服务器实例级负载均衡的收益 #

有明确收益，核心体现在三个方面：

• 多核资源利用：单个.NET API实例默认仅占用一个CPU核心，多实例可充分利用服务器多核CPU，显著提升高并发场景下的吞吐量。
• 服务容错性：单个实例崩溃时，Nginx会自动将请求转发到正常实例，避免服务完全中断。
• 平滑部署：更新版本时可逐个启停实例，实现零停机部署，不影响用户访问。

注意：如果服务器CPU、内存资源已饱和，多实例会引发资源竞争，反而降低性能，需根据服务器配置调整实例数量。

关于launchsettings.json的问题 #

launchsettings.json是开发环境的启动配置文件，配置多个端口后每个实例都会监听所有端口，这是它的设计逻辑，不适合用来实现多实例的端口隔离，建议改用上述两种方式。

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