.NET 8 Blazor部署Azure时出现App相关错误求助

一、根源分析 #

1. “找不到类型或命名空间名称‘App’”错误：

   • 核心原因是App.razor组件未被正确纳入构建流程，或者命名空间与program.cs中的引用不匹配。Azure的Release构建对项目配置的校验比本地Debug更严格，一些本地忽略的配置错误会在部署时暴露。
   • 添加空App.razor.cs的操作只是临时绕过了构建错误，但并未解决根因，反而导致根组件缺失，引发后续404问题。

2. Azure上的404错误：

   • App.razor是Blazor应用的根组件，负责路由分发。空的App.razor.cs无法生成有效的根组件实例，导致应用启动后没有可渲染的内容，最终触发404。

二、分步解决方案 #

1. 修复App.razor的构建配置 #

• 检查App.razor的项目状态：
  右键项目中的App.razor文件，查看属性：

  • 确保“生成操作”设置为Razor组件（而非None或其他）。
  • 如果App.razor不在项目中，右键项目→添加→现有项，重新将其纳入项目。

• 统一命名空间：
  在App.razor顶部添加与program.cs一致的命名空间：

  @namespace Redacted.MyAppName.Web.Admin
  

• 清理csproj中的错误配置：
  打开你的csproj文件，修正错误的<Compile Update>节点：

  • 比如ThingNotificationAdd - Copy.razor.cs的<DependentUpon>指向了.razor.cs文件，这是错误的，应该指向对应的.razor文件：

    <Compile Update="Application\Feature\Steps\ThingNotificationAdd - Copy.razor.cs">
        <DependentUpon>ThingNotificationAdd - Copy.razor</DependentUpon>
    </Compile>
    

  • 检查是否有其他Razor组件被错误标记为<None>，确保所有.razor文件的生成操作都是RazorComponent。

2. 恢复有效的App.razor内容 #

删除你添加的空App.razor.cs文件，确保App.razor包含完整的路由逻辑，示例如下：

@namespace Redacted.MyAppName.Web.Admin
<Router AppAssembly="@typeof(Program).Assembly">
    <Found Context="routeData">
        <RouteView RouteData="@routeData" DefaultLayout="@typeof(MainLayout)" />
        <FocusOnNavigate RouteData="@routeData" Selector="h1" />
    </Found>
    <NotFound>
        <LayoutView Layout="@typeof(MainLayout)">
            <p>抱歉，该地址不存在。</p>
        </LayoutView>
    </NotFound>
</Router>

（如果你的项目有自定义布局，替换MainLayout为你的布局组件即可）

3. 验证本地Release构建 #

在本地执行Release模式构建并运行，复现Azure的构建环境：

dotnet publish -c Release
dotnet run --no-build -c Release

如果本地Release构建也出现错误，说明问题出在项目配置而非Azure环境，优先在本地修复。

4. 清理Azure部署缓存并重新部署 #

• 登录Azure门户，进入你的App Service→部署中心→点击“重新部署”。
• 或者在部署时添加--no-cache参数，避免使用旧的构建缓存：

  az webapp deploy --resource-group <你的资源组> --name <你的App Service名称> --src-path ./bin/Release/net8.0/publish --no-cache
  

5. 检查Azure构建日志 #

如果问题仍存在，查看Azure的构建日志：

• 进入App Service→部署中心→日志，查看完整的构建输出，定位具体的错误节点（比如是否有文件缺失、命名空间冲突等）。

三、额外注意事项 #

• 确保program.cs中的MapRazorComponents引用的App类与App.razor的命名空间完全一致：

  app.MapRazorComponents<Redacted.MyAppName.Web.Admin.App>().AddInteractiveServerRenderMode();
  

• 检查项目中是否存在重复的App类（比如其他文件中意外定义了同名类），导致命名空间冲突。

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