Blazor Server因fbclid查询参数启动失败，求解决方案

报错The URI 'http://myhost/myapp?fbclid=[...]' is not contained by the base URI 'http://myhost/myapp/'的核心原因是：你的Blazor应用配置的基础URI是带末尾斜杠的/myapp/，但Facebook跳转的URL是不带末尾斜杠的/myapp加查询参数，导致Blazor路由系统判定请求URI不在基础范围内，启动失败。添加fbclid的查询参数声明无法解决这个基础URI匹配问题，以下是可行的调整方案：

方案1：服务器端重写/重定向（推荐） #

通过服务器配置，将不带末尾斜杠的/myapp?xxx请求重定向到带斜杠的/myapp/?xxx，确保和Blazor的基础URI匹配：

• IIS：在web.config中添加重写规则：

  <rewrite>
    <rules>
      <rule name="Add trailing slash" stopProcessing="true">
        <match url="^myapp$" />
        <conditions>
          <add input="{QUERY_STRING}" pattern=".+" />
        </conditions>
        <action type="Redirect" url="myapp/?{QUERY_STRING}" redirectType="Permanent" />
      </rule>
    </rules>
  </rewrite>
  

• Apache：在.htaccess中添加：

  RewriteCond %{REQUEST_URI} ^/myapp$
  RewriteCond %{QUERY_STRING} .+
  RewriteRule ^(.*)$ $1/?%{QUERY_STRING} [R=301,L]
  

• Nginx：在配置中添加：

  location = /myapp {
    if ($args) {
      return 301 $uri/?$args;
    }
  }
  

方案2：Blazor页面内JS重定向 #

如果无法修改服务器配置，可以在Blazor的入口页面（Blazor Server的_Host.cshtml或WebAssembly的index.html）中添加一段JavaScript，自动修正URL：

<script>
    // 替换为你的应用子路径，根路径则用 '/'
    const appBasePath = '/myapp';
    const currentPath = window.location.pathname;
    const hasQueryParams = window.location.search !== '';

    // 检查当前路径是应用根路径（无末尾斜杠）且带有查询参数
    if (currentPath === appBasePath && hasQueryParams) {
        // 重定向到带末尾斜杠的URL并保留查询参数
        window.location.replace(`${appBasePath}/${window.location.search}`);
    }
</script>

方案3：调整Blazor基础路径配置 #

确保你的Blazor应用基础路径配置正确：

• Blazor Server：在Pages/_Host.cshtml中设置正确的<base href>：

  <base href="/myapp/" />
  

  同时在Program.cs中添加路径基配置：

  app.UsePathBase("/myapp");
  

• Blazor WebAssembly：在wwwroot/index.html中设置：

  <base href="/myapp/" />
  

配置后结合方案1或方案2的重定向，即可确保请求URL与基础URI匹配，Blazor应用可正常启动。

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