Blazor 发布到 Azure App Service 教程

Blazor应用部署到Azure App Service需区分Server与WebAssembly类型：Server需.NET运行时支持，WebAssembly可作静态网站部署；推荐VS一键发布或GitHub Actions自动部署，并注意WebSocket启用、base href配置及MIME类型问题。

Blazor 应用（尤其是 Blazor Server 或 Blazor WebAssembly）发布到 Azure App Service 是常见且成熟的部署方式。关键在于区分项目类型、正确配置发布管道、处理静态资源与后端依赖，并注意 Azure App Service 的运行环境限制。

确认 Blazor 类型再选部署策略

Blazor Server 和 Blazor WebAssembly 部署方式不同，不能混用：

• Blazor Server：需要 .NET 运行时支持，必须部署到支持 Windows/Linux 的 App Service（.NET Core/.NET 6+），选择“App Service (Windows)”或“App Service (Linux)”并指定对应 .NET 版本（如 .NET 8）。
• Blazor WebAssembly（独立模式）：本质是静态网站，可直接部署到 App Service（Windows/Linux）的静态文件托管路径（wwwroot），无需后端运行时；也可部署到 Azure Static Web Apps（更轻量、免费层友好）。

使用 Visual Studio 一键发布（推荐新手）

适合本地开发完成、快速验证场景：

• 右键项目 → “发布” → “Azure” → “Azure App Service” → 登录账号。
• 选择或新建资源组、App Service（建议选 Linux + .NET 8 Runtime，更稳定且成本低）。
• 发布前勾选“删除目标位置中不存在的文件”，避免旧文件残留干扰。
• 发布完成后，访问 https://your-app-name.azurewebsites.net 即可打开应用。

通过 GitHub Actions 自动部署（推荐生产环境）

实现代码 push 后自动构建、发布，提升可靠性与可追溯性：

Pippit AI

CapCut推出的AI创意内容生成工具

133

查看详情

• 在项目根目录添加 .github/workflows/deploy-blazor.yml。
• 对 Blazor Server：使用 actions/setup-dotnet 安装 .NET SDK，执行 dotnet publish -c Release -o ./publish，再用 Azure/webapps-deploy 推送整个 publish 文件夹。
• 对 Blazor WebAssembly：只需构建前端（dotnet publish -c Release 输出 wwwroot 内容），用 Azure/webapps-deploy@v2 部署静态文件即可，无需运行时配置。
• 务必在 GitHub Secrets 中安全存储 AZURE_WEBAPP_PUBLISH_PROFILE（从 Azure 门户下载发布配置获取）。

常见问题与关键检查点

部署后打不开？多半卡在这几个地方：

• HTTP 重定向未启用：Blazor Server 默认依赖 WebSocket，若 App Service 的“HTTP 版本”设为 1.1 且未开启“WebSockets”，页面会白屏或反复刷新。进 Azure 门户 → App Service → “设置” → “配置” → “常规设置”，确保“WebSockets”为“开启”。
• 路径基础不匹配：如果应用部署在子路径（如 /myapp/），需在 index.html 中修改 <base href="/myapp/">，并在 Program.cs 中调用 app.UsePathBase("/myapp")（仅 Blazor Server）。
• 静态文件 MIME 类型缺失（WebAssembly）：Azure App Service 默认不识别 .dll 或 .wasm 文件。在 web.config（Windows）或 mime.types（Linux Nginx）中补充类型映射，或改用 Azure Static Web Apps 避免此问题。

基本上就这些。只要分清 Blazor 类型、选对运行环境、配好构建输出路径，再留意 WebSocket 和 base href 这两个高频坑，发布过程很顺。

以上就是Blazor 发布到 Azure App Service 教程的详细内容，更多请关注php中文网其它相关文章！