.NET 8 Blazor 静态服务器渲染(SSR)怎么用-C#.Net教程-PHP中文网

Blazor 在 .NET 8 中正式支持静态服务器渲染（SSR），即在无用户会话、无 JS 交互、无 HttpContext 依赖前提下同步生成可缓存 HTML；适用于博客、文档等静态内容场景，需使用 Blazor Web App 模板并配置 [RenderModeStaticServer]，禁用有状态服务与异步操作。

.net 8 blazor 静态服务器渲染(ssr)怎么用

Blazor 在 .NET 8 中正式支持**静态服务器渲染（Static Server Rendering，简称 SSR）**，但它不是传统意义上的“纯静态 HTML 预生成”，而是指：在服务器端**不依赖用户会话、不执行 JS 交互逻辑、不访问 HttpContext 或用户特定状态**的前提下，同步生成完整 HTML 并直接返回给浏览器——即“无状态的、可缓存的服务器端渲染”。它适用于博客、文档页、营销页等内容稳定、无需实时交互的场景。

核心前提：启用静态 SSR 模式

必须使用 Blazor Web App 模板（.NET 8 新建项目默认类型），并在 Program.cs 中显式配置渲染模式为 StaticServer：

组件需标记为 [RenderModeStaticServer]（或全局配置路由级渲染模式）
不能使用 @inject 注入 HttpContext、NavigationManager、AuthenticationStateProvider 等有状态服务
禁止调用 StateHasChanged()、InvokeAsync() 或任何触发重渲染的逻辑
数据应通过参数（[Parameter]）传入，或在 OnInitialized 中同步获取（如读取本地 JSON 文件、常量数据）

如何写一个静态 SSR 页面

以 Pages/About.razor 为例：

@page "/about"
@attribute [RenderModeStaticServer]

<h1>关于我们</h1>
<p>创建时间：@DateTime.UtcNow.ToString("yyyy-MM-dd")</p>
<p>版本号：@AppVersion</p><div class="aritcle_card flexRow artxards">
											<div class="artcardd flexRow">
												<a class="aritcle_card_img" rel="nofollow" href="/xiazai/skill10520" title="Seo Listing"><img
														src="https://img.php.cn/upload/skill/000/000/081/179319078336540.jpg" alt="Seo Listing" onerror="this.onerror='';this.src='/static/lhimages/moren/morentu.png'" ></a>
												<div class="aritcle_card_info flexColumn">
													<a rel="nofollow" href="/xiazai/skill10520" title="Seo Listing" class="overflowclass">Seo Listing</a>
													<p class="overflowclass">跨境电商SEO优化与Listing文案生成专家，擅长将中式英语或基础卖点转化为本土化、高转化率且符合SEO规范的文案。</p>
												</div>
												<a rel="nofollow" href="/xiazai/skill10520" title="Seo Listing" class="aritcle_card_btn flexRow flexcenter"><b></b><span>下载</span>
												</a>
											</div>
										</div>

@code {
    public string AppVersion = "v1.0.0"; // 编译期/启动时确定，非运行时动态查
}

注意：
– 不要写 @DateTime.Now（每次请求都变，破坏静态性）
– 不要调用 HttpClient 获取远程 API（非同步、不可缓存）
– 所有数据必须是确定性的、可提前计算的

配合输出缓存提升性能

静态 SSR 内容天然适合 HTTP 缓存。在 Program.cs 中为静态路由添加缓存策略：

app.UseStaticFiles();
app.UseRouting();

// 对 /about 等静态页面启用 1 小时响应缓存
app.MapGet("/about", () => Results.Content("<h1>关于我们</h1>...", "text/html"))
   .CacheOutput(policy => policy.Expire(TimeSpan.FromHours(1)));

或者更推荐：用 MapRazorComponents + AddAdditionalAssemblies 后，配合 CacheOutput 特性对整个组件路由生效。

和传统预渲染（Prerendering）的区别

.NET 8 的静态 SSR ≠ 旧版 Blazor Server 的 Prerendering：
– Prerendering 是“先服务端跑一次组件 → 输出 HTML → 再启动客户端接管”，仍需下载 WASM/JS、建立 SignalR 连接
– 静态 SSR 是“只服务端输出一次 HTML，无后续交互能力”，页面完全静态，不加载 Blazor 运行时
– 静态 SSR 页面打开快、SEO 友好、CDN 可缓存；但无法响应点击、输入等事件（除非你额外加轻量 JS）

基本上就这些。用对了场景，静态 SSR 能显著降低首屏时间与服务器压力，不复杂但容易忽略“无状态”这个硬约束。