部署到服务器后Blazor WASM路由无法正确使用基础URI问题排查（NavigationManager.NavigateTo()方法）

我之前也碰到过一模一样的坑！别慌，咱们一步步拆解问题根源，找到最优雅的解决方案：

核心问题：NavigateTo("/mypage")的写法忽略了base href #

你可能没注意到，Blazor的NavigationManager.NavigateTo方法里，以斜杠开头的路径是相对于网站根域名的，而不是你设置的<base href>。所以哪怕你把base href改成/MyApp/，调用NavigateTo("/mypage")依然会跳转到test.com/mypage，完全跳过了子文件夹路径。

解决方案一：改用相对路径调用NavigateTo #

把代码里的路径开头的斜杠去掉，直接写相对路径：

// 原来的写法（错误）
NavigationManager.NavigateTo("/mypage");

// 修改后的写法（正确）
NavigationManager.NavigateTo("mypage");

这样不管是本地调试（base href为/）还是部署到/MyApp/，路由都会自动拼接base href的路径，本地跳转到localhost:44303/mypage，服务器上跳转到test.com/MyApp/mypage，完美适配两种环境，不用写任何条件代码。

解决方案二：确保base href的设置正确且不被覆盖 #

虽然你说已经改了base href，但可能存在设置方式不对导致发布后被覆盖的情况，推荐两种可靠的设置方式：

方式1：通过发布命令动态设置

发布时直接指定base href参数，避免手动修改index.html：

dotnet publish -c Release /p:BaseHref=/MyApp/

这种方式会自动替换发布包中index.html的<base href>值，不会出现本地和发布环境不一致的问题。

方式2：在项目文件（.csproj）中配置

打开你的Blazor项目文件，在<PropertyGroup>节点下添加BaseHref配置：

<PropertyGroup>
  <!-- 本地调试默认用/ -->
  <BaseHref>/</BaseHref>
</PropertyGroup>

<!-- 发布时覆盖为子路径 -->
<PropertyGroup Condition="'$(Configuration)' == 'Release'">
  <BaseHref>/MyApp/</BaseHref>
</PropertyGroup>

这样本地调试用/，发布Release版本自动切换为/MyApp/，一次配置终身省心。

额外检查：服务器的SPA路由配置 #

如果上述步骤做完后，刷新页面还是出现404，那大概率是服务器没有配置SPA fallback路由。以IIS为例，需要在web.config中添加重写规则，把所有子路径的请求转发到index.html：

<system.webServer>
  <rewrite>
    <rules>
      <rule name="Blazor SPA Fallback" stopProcessing="true">
        <match url=".*" />
        <conditions>
          <add input="{REQUEST_FILENAME}" matchType="IsFile" negate="true" />
          <add input="{REQUEST_FILENAME}" matchType="IsDirectory" negate="true" />
        </conditions>
        <action type="Rewrite" url="index.html" />
      </rule>
    </rules>
  </rewrite>
</system.webServer>

其他服务器（比如Nginx、Apache）也需要类似的配置，确保非静态文件的请求都路由到Blazor的入口文件。

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