Blazor WebAssembly部署Azure静态Web应用无行号错误问题

本地开发时，Blazor WebAssembly应用抛出异常能显示带文件路径、行号的完整详情，但部署到Azure Static Web Apps后只能看到简化的异常信息，没法定位具体出错位置。

本地环境异常显示：

Azure静态Web应用环境异常显示：

解决办法： #

• 部署时必须包含调试符号文件
  默认发布Blazor WASM不会把.pdb调试符号文件打包到生产环境。修改项目的.csproj文件，添加以下配置，发布时就能带上符号：

  <PropertyGroup>
    <PublishTrimmed>false</PublishTrimmed> <!-- 如果开了代码剪裁可能丢符号，按需调整 -->
    <DebugType>embedded</DebugType> <!-- 把符号嵌入程序集，也可以设为portable生成独立pdb -->
    <DebugSymbols>true</DebugSymbols>
  </PropertyGroup>
  

  或者用发布命令指定参数：

  dotnet publish -c Release /p:DebugType=embedded /p:DebugSymbols=true
  

• 配置Azure Static Web Apps的应用设置
  登录Azure门户，找到你的Static Web Apps资源，进入配置→应用程序设置，加两个配置项：

  • 键：ASPNETCORE_ENVIRONMENT，值：Development（仅用来调试，排查完记得改回Production）
  • 键：BlazorEnableDebugging，值：true

• 关闭异常信息简化处理
  在应用的Program.cs里，确保没覆盖默认异常处理，或者显式配置保留详细异常：

  builder.Services.AddBlazorWebAssemblyOptions(options =>
  {
      options.DetailedErrors = true;
  });
  

  注意：生产环境别开DetailedErrors，防止泄露敏感信息，只在排查问题时用。

• 检查部署流水线配置
  如果用GitHub Actions或Azure DevOps部署，要确认发布步骤里的命令正确带了调试符号参数，默认脚本可能没加，得手动补上。

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