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 后自动构建、发布，提升可靠性与可追溯性：
在项目根目录添加.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 这两个高频坑，发布过程很顺。
