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

来源:这里教程网 时间:2026-02-21 17:34:42 作者:

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

明确各自适用场景

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

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

不推荐在同一个项目里混用两种渲染模型,而是将应用按功能域拆成两个独立项目(BlazorServerAppBlazorWasmApp),再通过统一入口(如 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 中心:

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 承担轻量、自主、离线的部分。架构清晰了,维护和扩展反而更简单。

相关推荐