Blazor Server 与 WASM 混合部署模式教程-C#.Net教程-PHP中文网

Blazor Server 与 WASM 混合部署模式教程

畫卷琴夢

发布： 2025-12-21 09:51:08

原创

846人浏览过

Blazor Server与Blazor WASM混合部署可兼顾首屏速度、离线能力与服务端实时性，关键在于按场景拆分路由并用反向代理智能分发：/admin/走Server实现实时监控与权限敏感操作，/docs/、/app/*走WASM支持离线访问与PWA，共享.NET Standard类库与统一API鉴权，Nginx配置路由转发与静态资源托管。

blazor server 与 wasm 混合部署模式教程

Blazor Server 和 Blazor WASM 并非互斥方案，混合部署能兼顾首屏速度、离线能力与服务端实时性——关键在于按场景拆分路由，用反向代理做智能分发。

明确各自适用场景

Blazor Server 适合需要高实时性、强服务端依赖、低客户端算力要求的页面，比如后台管理中的实时监控看板、权限敏感的数据录入表单；Blazor WASM 更适合静态内容多、需离线访问、SEO 友好或跨平台 PWA 场景，例如帮助中心、产品介绍页、用户自助仪表盘（含本地缓存逻辑）。

路由级分离：前端决定加载模式

不推荐在同一个项目里混用两种渲染模型，而是将应用按功能域拆成两个独立项目（BlazorServerApp 和 BlazorWasmApp），再通过统一入口（如 ASP.NET Core Hosted 网站）协调。核心是让浏览器首次请求时就命中对应宿主：

/admin/* → 反向代理转发到 Blazor Server 应用（SignalR 连接保持）
/docs/*、/app/* → 静态托管 Blazor WASM 的 _framework/ 资源，由 Nginx 或 CDN 直接返回
根路径 / 可设为重定向页或轻量门户页，用 JavaScript 检测网络/设备后跳转最优入口

共享代码与状态协同

共用类库（.NET Standard 2.1+）存放模型、服务接口、验证逻辑和可复用组件（注意：WASM 不支持部分 System.* API，如文件 IO、线程池）。状态同步靠后端统一 API 中心：

CodeBuddy

腾讯云AI代码助手

805

查看详情

Blazor WASM 通过 HttpClient 调用 REST/GraphQL 接口，JWT 鉴权
Blazor Server 使用同样的接口封装（如 Refit 或自定义 ServiceClient），但可额外启用 SignalR Hub 实现实时推送（如通知提醒）
用户登录态建议由 IdentityServer 或 ASP.NET Core Identity 统一管理，Cookie + Bearer Token 双模支持

部署与反向代理配置示例（Nginx）

一个典型 nginx.conf 片段：

location /admin/ {
  proxy_pass https://blazor-server-app/;
  proxy_http_version 1.1;
  proxy_set_header Upgrade $http_upgrade;
  proxy_set_header Connection "upgrade";
}
location /docs/ {
  alias /var/www/blazor-wasm/docs/;
}
location /app/ {
  alias /var/www/blazor-wasm/app/;
}
location / {
  try_files $uri $uri/ /index.html;
}

注意：WASM 静态资源需开启 gzip、设置正确 MIME 类型（特别是 .dll 文件为 application/wasm），Server 端需配置 CORS 允许 WASM 域名调用 API。

基本上就这些。混合不是为了炫技，而是让每个请求走最合适的路径——Server 做它擅长的实时交互，WASM 承担轻量、自主、离线的部分。架构清晰了，维护和扩展反而更简单。

以上就是Blazor Server 与 WASM 混合部署模式教程的详细内容，更多请关注php中文网其它相关文章！