【ASP.NET Core】Blazor 服务器端的 Base Path
source link: https://www.cnblogs.com/tcjiaan/p/14237072.html
Go to the source link to view the article. You can view the picture content, updated content and better typesetting reading experience. If the link is broken, please click the button below to view the snapshot at that time.
【ASP.NET Core】Blazor 服务器端的 Base Path
提到 Blazor，没准就会有人问：选用 Server 端还是 WebAssembly（客户端）？其实这个不用纠结，老周个人的原则是：Server 端优先。理由很单纯：服务器端虽然消耗服务器上的资源，但加载速度快，而且不用下载组件（几个脚本也不大）。其实嘛，Web 应用都是消耗服务器资源的，不然要服务器干吗呢。
那啥时候选用 Web Assembly 呢？应该在交互比较繁复时。比如，你开发了个游戏，叫《国民 996》，这样的话选用客户端是比较合适。
======================================================================
Du Du, Stop！题外话结束。今天要说的话题是服务器端的 Blazor应用方面的。各位估计都玩过 Blazor 了，在加载组件的 HTML 文档中，通常会在 <head> 元素下指定一个应用程序的基础路径，也就是 Base Path。就像这样：
<head>
<base href="/" />
</head>
然后，<body>里面的脚本导入就会相对于上面指定的路径。
<script src="_framework/blazor.server.js"></script>
在 99.996% 的场合中，你只需要为应用程序指定“/”作为基础路径就可以了。当浏览器发来请求时，服务器就会从根路径开始匹配 URL 路由，然后定位到目标组件并加载。
但是，在 0.004% 的场合中，这个<base>元素可能要加上一个前缀。比如：/demo。那什么场合呢？Duang，来了：
1）ASP.NET Core（Blazor）应用程序绑定本机地址运行，如著名的 localhost:5000；
2）使用其他服务器组件来反向代理，世界闻名的有 爱爱S、阿Pache，ng拽nx之类。
3）IIS、nginx等上面配置了路径前缀。
以 nginx 为例，假设有这样的配置：
server {
listen 80;
……
location / {
root html;
index index.html index.htm;
}
location /blazapp/ {
proxy_pass http://localhost:5000;
proxy_http_version 1.1;
proxy_set_header Upgrade $http_upgrade;
proxy_set_header Connection keep-alive;
proxy_set_header Host $host;
proxy_cache_bypass $http_upgrade;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
proxy_set_header X-Forwarded-Proto $scheme;
proxy_set_header Connection "Upgrade";
}
如果访问根路径 / ，那么指向 index.html 等文件；若访问 /blazapp 前缀打头的路径才指向我的 Blazor 应用。 proxy_xxx 配置的转发规则会把这个路径前缀也转发给 ASP.NET Core 应用进程，所以，这时候，咱们用来加载 blazor 组件的HTML文档就要这样写 <base> 了。
<head>
<base href="/blazapp" />
</head>
看，这个 Base Path 就是这么用的。
注意 blazor 组件的代码是不需要改动的，比如这个叫 home 的组件。
@page "/home" <h3>豆腐小镇欢迎您</h3>
@page 指令后面的URL不需要添加前缀。
但，Startup 类里面的 Configure 方法里面的代码就要做点手脚了。
1）调用 UseForwardedHeaders 方法。这个与 blazor 关系不大，使用反向代理的话都应该调用，以让应用程序读取转发的头；
2）调用 UsePathBase 方法，设置的路径前缀要和前面 nginx 中配置的一致。这一句是重点，它的作用是把传入应用程序的URL中的前缀去掉。
public void Configure(IApplicationBuilder app, IWebHostEnvironment env)
{
app.UseForwardedHeaders();
app.UsePathBase("/blazapp");
if (env.IsDevelopment())
{
app.UseDeveloperExceptionPage();
}
app.UseStaticFiles(); //这句别忘了
app.UseRouting();
app.UseEndpoints(endpoints =>
{
endpoints.MapBlazorHub();
endpoints.MapFallbackToPage("/Host");
});
}
这时候，从浏览器中访问 http://localhost/blazapp/home，组件就显示出来了。
当从浏览器发出请求 localhost/blazapp/home 时，nginx 会把路径 /blazapp/home 转发给 ASP.NET Core 应用程序。
ASP.NET Core 应用程序收到消息后，由于调用了 app.UsePathBase("/blazapp")，自动把 /blazapp 这一段砍掉了，于是，传给 Routing 的 URL 又恢复到 /home，所以，我们写的 blazor 组件是不用去改路径规则的。
Web Assembly 应用也能使用这个 Base Path 设置，不过用处不是很大，除非你一个服务器应用承载多个 webasm 应用。同时下载多个 webasm 应用也用得不多。如果确实要这样做，那么你的 Host 项目就要引用多个 webasm 项目，假设叫 app1、app2。这种方案你必须为每个 web asm 的项目文件（.csproj）加上 StaticWebAssetBasePath 节点。
例如，app1 应用的项目文件加上：
<StaticWebAssetBasePath>/path01</StaticWebAssetBasePath>
app2 应用的项目文件里加上：
<StaticWebAssetBasePath>/path02</StaticWebAssetBasePath>
如果不这样做，是无法编译的，因为 Webassembly 应用默认的路径前缀是“/”，如果你的 Host 程序引用了 N 个 Web Assembly 应用，那么就等于用一个“/”指向多个项目，这就冲突了，所以要在项目文件中加上 StaticWebAssetBasePath 配置，以解决此问题。StaticWebAssetBasePath 指定的是逻辑路径，并不要求真的存在这个目录（为了解决冲突用），你的项目文件可以放在名为 sb01、sb02 的目录下。
Recommend
About Joyk
Aggregate valuable and interesting links.
Joyk means Joy of geeK