ASP.NET API本地VS Web Server端口配置异常问题排查

你的问题核心在于手动创建的ConfigurationBuilder没有加载完整的配置源，导致ASP.NET无法读取launchSettings.json中的自定义端口配置，最终 fallback 到默认的5000/5001端口。

1. 两种配置方式的本质差异 #

情况2（正常生效）：使用默认builder.Configuration #

WebApplication.CreateBuilder(args)初始化时，会自动加载一系列默认配置源，其中包括：

• appsettings.json、appsettings.{Environment}.json
• 环境变量（VS启动时会把launchSettings.json里的applicationUrl转换成ASPNETCORE_URLS环境变量注入）
• 命令行参数
• 开发环境下的秘密管理器

这些配置源共同构成了builder.Configuration，所以ASP.NET能正确读取到launchSettings中的自定义端口。

情况1（端口失效）：手动创建ConfigurationBuilder #

你手动创建的ConfigurationBuilder只添加了appsettings.json这一个配置源，完全缺失了环境变量、命令行参数等关键源，导致ASP.NET无法获取到launchSettings传递的自定义端口，只能使用默认端口启动。

同时，VS是根据launchSettings里的端口监听进程，而你的应用实际在默认端口运行，所以VS会无限等待指定端口的监听进程，出现"假死"状态。

2. 如何修复情况1（如果坚持手动创建配置） #

如果必须自定义ConfigurationBuilder，需要把默认的配置源补全，尤其是AddEnvironmentVariables()，这样才能读取到VS注入的端口配置：

IConfiguration configuration = new ConfigurationBuilder()
    .SetBasePath(Directory.GetCurrentDirectory()) // 必须设置基础路径，否则可能找不到配置文件
    .AddJsonFile("appsettings.json", optional: false, reloadOnChange: true)
    .AddJsonFile($"appsettings.{builder.Environment.EnvironmentName}.json", optional: true)
    .AddEnvironmentVariables() // 关键：加载环境变量，包含launchSettings的端口配置
    .AddCommandLine(args)
    .Build();

builder.Services.AddSingleton(configuration);

3. 更推荐的做法 #

除非你有特殊需求（比如完全自定义配置加载逻辑），否则直接使用WebApplication.CreateBuilder提供的builder.Configuration即可。它已经帮你处理了所有常见配置源的加载，包括开发环境的launchSettings、生产环境的环境变量等，无需手动重复造轮子。

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