Blazor Server（.NET7）部署后Scoped CSS不生效问题求助

核心原因解析 #

Blazor Server的Scoped CSS在Release模式下依赖构建过程将组件级CSS编译并打包为静态资产（通常是{项目名}.styles.css，输出到wwwroot/css目录）。而dotnet build命令仅负责编译代码，不会执行发布所需的资产收集、编译打包步骤，导致Scoped CSS相关文件未被包含在部署包中，最终Azure App Service无法加载到样式。

另外，本地Release模式下直接用dotnet build运行也会出现同样问题——因为缺少编译后的Scoped CSS资产，组件只能以纯文本渲染；而添加UseStaticWebAssets()能临时解决本地问题，是因为该方法强制加载开发环境的静态资源路径，但生产环境Azure App Service的静态资源托管逻辑与开发环境冲突，导致容器启动崩溃，这也符合微软文档不建议生产环境使用该配置的说明。

排查步骤 #

• 本地Release构建验证：执行dotnet publish -c Release，查看输出目录（默认是bin/Release/net7.0/publish/wwwroot/css）是否存在{项目名}.styles.css文件。如果用dotnet build则不会生成该文件，直接验证问题根源。
• 检查构建管道命令：确认CI/CD管道中使用的是dotnet publish而非dotnet build。dotnet build仅生成编译后的程序集，不会处理Scoped CSS编译、静态资源打包等发布必需步骤。
• 验证发布包内容：下载Azure部署的压缩包，检查是否包含wwwroot/css/{项目名}.styles.css及相关Scoped CSS衍生文件。若缺失，说明构建步骤未正确生成资产。
• 项目配置检查：确认项目.csproj文件中未错误禁用Scoped CSS：

  <PropertyGroup>
    <ScopedCssEnabled>true</ScopedCssEnabled>
    <DisableScopedCssBundling>false</DisableScopedCssBundling>
  </PropertyGroup>
  

  （注：.NET7 Blazor Server默认启用Scoped CSS，若未修改过无需额外配置，但若之前手动禁用需恢复）
• Azure App Service文件验证：通过Kudu工具查看site/wwwroot/css目录，确认是否存在Scoped CSS文件。若不存在，直接指向构建打包环节的问题。

修复方案 #

1. 替换构建命令：将CI/CD管道中的dotnet build命令替换为dotnet publish，示例命令：

   dotnet publish -c Release -o $(Build.ArtifactStagingDirectory)
   

   该命令会完成编译、Scoped CSS编译打包、静态资源收集等所有发布必需步骤。
2. 移除生产环境不必要配置：删除Program.cs中的builder.WebHost.UseStaticWebAssets();代码，生产环境Azure App Service会自动托管wwwroot目录下的静态资源。
3. 重置项目默认配置：若项目配置被修改，恢复.csproj中Scoped CSS的默认启用状态，确保编译过程正常生成样式文件。

内容的提问来源于stack exchange，提问作者user18901997