Blazor Server项目部署至Azure需修改哪些配置？

一、Azure App Service 核心配置 #

• 应用设置（Application Settings）：
  • 把appsettings.Production.json里的敏感配置（比如CosmosDB连接字符串）移到App Service的应用设置里，别硬编码在文件里。部署时Azure会自动覆盖配置文件对应项，格式要写成ConnectionStrings:CosmosDbConnection（对应你配置文件里的层级结构）。
  • 一定要设置ASPNETCORE_ENVIRONMENT为Production，不然应用不会加载生产环境的配置。
• 平台设置（Configuration > General settings）：
  • 确认.NET版本和本地开发环境完全一致（比如.NET 6/7/8），版本错了直接启动失败。
  • 必须开启Web sockets：Blazor Server全靠WebSocket通信，没开的话页面铁定空白或者没法交互。

二、CosmosDB 访问配置 #

• 连接权限与密钥：
  • 检查CosmosDB账户的防火墙设置，要么允许App Service的IP访问，要么测试阶段先开“允许所有网络访问”（生产环境记得改回限定IP）。
  • 确认CosmosDB的访问密钥是对的，而且用的是读写密钥，别拿只读的来用。
• 配置文件参数：
  • appsettings.Production.json里的CosmosDb节点，DatabaseName和ContainerName要和Azure上的资源名称完全一致，注意大小写，错一个字符都连不上。
  • 连接字符串格式别写错：AccountEndpoint=https://<你的账户名>.documents.azure.com:443/;AccountKey=<你的密钥>;

三、Blazor Server 专属配置 #

• Program.cs 服务注册：
  • 别把CosmosDB服务的注册代码放在if (env.IsDevelopment())块里，生产环境也得加载这个服务。示例代码参考：

    builder.Services.AddSingleton<ICosmosDbService>(sp =>
    {
        var config = sp.GetRequiredService<IConfiguration>();
        var endpoint = config["CosmosDb:Endpoint"];
        var key = config["CosmosDb:Key"];
        var dbName = config["CosmosDb:DatabaseName"];
        return new CosmosDbService(endpoint, key, dbName);
    });
    

  • 确保app.MapBlazorHub()和app.MapFallbackToPage("/_Host")这两行代码在生产环境的管道配置里没被条件判断删掉，这俩是Blazor Server启动的关键。
• _Host.cshtml 页面配置：
  • 生产环境下要引用正确的Blazor脚本：<script src="_framework/blazor.server.js"></script>，别引用开发环境的调试版本。
  • <base href="/" />要设置对，如果你的App Service用了自定义域名或者虚拟目录，得对应修改base路径。

四、部署流程相关配置 #

• GitHub Actions/Visual Studio 部署检查：
  • 用GitHub Actions部署的话，看工作流文件（.github/workflows/azure-webapps.yml）里的.NET版本、构建命令（dotnet publish -c Release -o ./publish）是不是正确，有没有部署到你目标的App Service实例。
  • Visual Studio部署时，一定要选Release配置，部署前记得勾选“移除目标上的额外文件”，避免旧文件干扰。
• 部署后文件验证：
  • 通过App Service的“高级工具 > Kudu”看看部署后的文件全不全，尤其是publish目录下的_framework文件夹、配置文件有没有缺失。

五、错误排查辅助配置 #

• 开启日志查问题：
  • 在App Service的“监控 > 日志流”里开启应用日志，日志级别设为Error或Debug，看具体的启动错误或者运行时异常——比如CosmosDB连不上、依赖注入出错这些，日志里都会有线索。
  • 在Program.cs里加一行日志配置，确保日志能输出到Azure的日志系统：

    builder.Logging.AddAzureWebAppDiagnostics();
    

• 本地模拟生产环境：
  • 本地运行时设置环境变量ASPNETCORE_ENVIRONMENT=Production，模拟生产环境加载配置，排查是不是配置文件本身有问题。

内容的提问来源于stack exchange，提问作者Kk.cs