Blazor非开发环境下异常抛出与模态框展示的实现问题

嗨，我来帮你搞定Blazor非开发环境下异常模态框展示的问题～

你提到在开发环境下，API返回的异常能正常在模态框里展示，但切换到非开发环境（比如Production）就出问题了对吧？这其实是.NET的默认行为导致的——非开发环境下，服务器会自动屏蔽详细的异常信息，避免泄露敏感数据，所以客户端拿不到你预期的错误内容。下面给你一步步的解决方案：

第一步：配置服务器端的异常处理，控制返回的错误内容 #

首先得在Server项目的Program.cs里调整异常处理逻辑，让非开发环境下也能返回我们需要的（且安全的）错误信息：

if (app.Environment.IsDevelopment())
{
    app.UseDeveloperExceptionPage(); // 开发环境保留详细异常页
}
else
{
    // 自定义非开发环境的异常处理中间件
    app.UseExceptionHandler(errorApp =>
    {
        errorApp.Run(async context =>
        {
            context.Response.StatusCode = StatusCodes.Status500InternalServerError;
            context.Response.ContentType = "application/json";

            var exceptionFeature = context.Features.Get<IExceptionHandlerPathFeature>();
            if (exceptionFeature?.Error != null)
            {
                // 这里可以自定义返回的错误内容，注意不要泄露敏感信息！
                var errorResponse = new
                {
                    Message = "服务器出现错误，请联系管理员",
                    // 如果需要给特定用户展示详细信息，可加判断后开启下面的字段
                    // DetailedMessage = exceptionFeature.Error.Message
                };

                var json = JsonSerializer.Serialize(errorResponse);
                await context.Response.WriteAsync(json);
                
                // 同时把详细异常记录到日志，方便排查问题
                var logger = context.RequestServices.GetRequiredService<ILogger<Program>>();
                logger.LogError(exceptionFeature.Error, "服务器异常，请求路径：{Path}", exceptionFeature.Path);
            }
        });
    });
    app.UseHsts();
}

如果你的API是用Controller写的，也可以在Action里手动捕获异常，返回自定义的ObjectResult，确保内容格式统一。

第二步：优化客户端的异常解析逻辑 #

非开发环境下服务器返回的是JSON格式的错误信息，而不是纯文本，所以你需要调整客户端的代码来解析这个JSON：

if (!response.IsSuccessStatusCode)
{
    teamProcessing = false;
    string errorMessage = string.Empty;
    try
    {
        // 先尝试解析JSON格式的错误响应
        var errorDict = await response.Content.ReadFromJsonAsync<Dictionary<string, string>>();
        if (errorDict != null && errorDict.TryGetValue("Message", out string msg))
        {
            errorMessage = msg;
        }
        else
        {
            // 解析失败的话， fallback到读取纯文本
            errorMessage = await response.Content.ReadAsStringAsync();
        }
    }
    catch
    {
        // 兜底处理，避免解析失败导致程序崩溃
        errorMessage = $"请求失败，状态码：{response.StatusCode}";
    }
    await ShowTheExceptionModal(errorMessage);
}

第三步：确认模态框组件能正确接收并展示消息 #

检查你的Message_Modal组件，确保参数绑定正确（注意参数名大小写要和你传递的一致）：

<div class="modal-body">
    <p>@message</p>
</div>
<div class="modal-footer">
    <button type="button" class="btn btn-secondary" @onclick="CloseModal">关闭</button>
</div>

@code {
    [Parameter]
    public string message { get; set; } = string.Empty;

    [Inject]
    private IModalService ModalService { get; set; } = default!;

    private void CloseModal()
    {
        ModalService.Close(ModalResult.Ok());
    }
}

注意哦，你之前传递的参数名是"message"，所以组件里的参数名要严格对应，否则会接收不到内容。

额外小贴士 #

• 非开发环境下，永远不要把服务器的堆栈信息返回给客户端，避免泄露系统结构等敏感数据；
• 服务器端一定要做好日志记录，这样即使客户端看不到详细异常，你也能通过日志排查问题；
• 如果需要给特定用户（比如管理员）展示详细异常，可以在返回时添加权限判断，只给有权限的用户返回详细信息。

备注：内容来源于stack exchange，提问作者Stavros Koureas