.NET 6中使用UseExceptionHandler自定义错误页显示空白问题求助

问题现象 #

配置自定义错误页后，触发异常时Shared/Error方法和视图均执行，但浏览器显示空白页，网络请求返回500状态码；访问不存在的页面触发404时，同样显示空白且无处理器响应。

解决方案 #

1. 重置响应状态码 #

UseExceptionHandler会保留原始异常的500状态码，浏览器可能因收到错误状态码而拒绝渲染页面，需在Error方法中手动重置：

public IActionResult Error()
{
    Response.StatusCode = 200;
    return View(new ErrorViewModel());
}

2. 排查布局页加载问题 #

空白页多因_Layout.cshtml加载失败导致：

• 确认_Layout.cshtml位于Views/Shared目录下
• 临时注释Error视图中的Layout = "_Layout";，测试基础错误内容是否能显示，以此区分是布局还是视图本身的问题
• 检查布局页内的静态资源（CSS/JS）路径是否正确，确保UseStaticFiles中间件能正常加载这些资源

3. 添加404错误处理 #

当前仅配置了服务器异常捕获，未处理404，需补充：

// 在中间件管道最前端添加（紧跟UseExceptionHandler）
app.UseStatusCodePagesWithReExecute("/Shared/NotFound");

同时在SharedController中添加对应方法：

public IActionResult NotFound()
{
    Response.StatusCode = 404;
    return View();
}

创建Views/Shared/NotFound.cshtml视图。

4. 检查BaseController的CheckLogin方法 #

若ErrorViewModel继承自BaseModel，需确认CheckLogin方法是否因配置缺失（如Config:BaseAddress未在appsettings.json中设置）抛出异常，导致视图渲染中断：

• 验证appsettings.json中Config:BaseAddress的配置值
• 临时注释CheckLogin的调用逻辑，测试错误页是否能正常显示

5. 调整中间件顺序 #

确保异常处理中间件位于管道最前端，保证所有请求异常都能被捕获：

var app = builder.Build();

// 异常处理与状态码处理放在最前面
app.UseExceptionHandler("/Shared/Error");
app.UseStatusCodePagesWithReExecute("/Shared/NotFound");

if (!app.Environment.IsDevelopment())
{
    app.UseHsts();
}

app.UseHttpsRedirection();
app.UseStaticFiles();
app.UseRouting();
app.UseAuthorization();

app.MapControllerRoute(
    name: "default",
    pattern: "{controller=Home}/{action=Index}/{id?}");

app.Run();

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