如何在AppSettings中设置Blazor WASM的宿主URL

首先明确核心逻辑差异：Blazor WASM是运行在浏览器沙箱内的纯客户端应用，不存在传统ASP.NET Core服务端"监听绑定端口/URL"的能力，你之前熟悉的ASPNETCORE_URLS配置、.UseUrls()方法都是服务端Kestrel/IIS的监听配置，天然不适用于WASM客户端本身。

不同场景的标准实现方式 #

1. 本地开发阶段自定义启动地址 #

你之前覆写launchSettings.json中applicationUrl的做法，本质是修改本地开发服务器（IIS Express/dotnet watch内置的静态文件服务器）的监听地址。

注意：launchSettings.json仅在本地开发环境生效，生产部署阶段不会读取该文件的任何配置，流水线中覆写这个文件对生产环境访问地址没有任何作用。

如果不想硬改launchSettings.json，直接在启动命令中传入参数即可，不需要修改任何项目文件，CI/CD流水线中临时启动服务做验证时用这种方式更简洁规范：

dotnet run --urls "http://自定义IP:自定义端口"

2. 配置WASM应用的运行时基址 #

如果你需要根据不同环境（开发/测试/生产）配置WASM应用的根访问路径（比如部署在站点子路径、不同域名下），不需要找.UseUrls()方法，正确做法是配置WASM的基址（base href）：

• 静态配置：直接修改wwwroot/index.html中的<base href="/" />标签的href值为实际的应用根路径即可。
• 动态读取appsettings.json配置：在Program.cs中构建宿主时读取自定义配置，动态传入基址参数：

var builder = WebAssemblyHostBuilder.CreateDefault(args);
// 从appsettings配置中读取自定义的应用基址
var appBase = builder.Configuration.GetValue<string>("AppSettings:ApplicationBasePath");
// 注册根组件时传入动态基址，等价于动态修改base标签href
builder.RootComponents.Add<App>("#app", baseHref: appBase ?? "/");

// 其余服务注册、配置逻辑保持不变
await builder.Build().RunAsync();

3. 生产环境配置访问地址 #

根据部署模式对应处理即可：

• 如果是ASP.NET Core托管模式（WASM文件由后端Server项目承载对外提供）：实际监听端口、绑定URL的是后端Server项目，直接在Server项目中使用ASPNETCORE_URLS环境变量、.UseUrls()方法配置即可，和普通ASP.NET Core应用配置方式完全一致，不需要改动WASM项目的任何代码。
• 如果是独立静态部署模式（WASM发布后是纯静态文件，部署在Nginx、CDN、对象存储等静态文件服务上）：WASM本身没有服务端能力，访问URL、端口绑定完全由你使用的静态文件服务器规则决定，直接在对应Web服务器/CDN上配置域名、端口、路由规则即可，和WASM项目本身无关。

为什么WebAssemblyHostBuilder没有.UseUrls()方法 #

这个API是服务端宿主用来绑定本地监听端口的，WASM运行在浏览器沙箱中，没有权限监听本地端口、对外提供HTTP服务，所有网络请求都由浏览器发起，因此微软没有为WASM客户端宿主设计这个API，不是功能缺失，是场景本身不需要。

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