ASP.NET Core 8 MVC中jquery-ajax-unobtrusive意外异常处理最佳实践

在ASP.NET Core 8 MVC项目里用jquery-ajax-unobtrusive发起Ajax请求，成功返回PartialView一切正常，但遇到数据库超时这类意外异常时，不想用弹窗或局部div展示错误信息，希望直接复用项目预设的自定义错误页（带统一样式），而不是绕过这套错误处理机制。

之前尝试通过document.write(jqXHR.responseText)替换页面内容，但只拿到异常详情，不是渲染好的错误页HTML，核心问题在于Ajax请求不会自动触发整页回发的重定向逻辑，同时开发环境和生产环境的异常处理管道行为不同。

解决步骤 #

1. 后端配置生产环境错误处理管道

在Program.cs中配置生产环境的异常处理中间件，指向自定义的错误页路由：

// 配置HTTP请求管道
if (!app.Environment.IsDevelopment())
{
    app.UseExceptionHandler("/Error/Error");
    // 默认HSTS值为30天，生产环境可按需调整
    app.UseHsts();
}

这个配置会让生产环境下的所有未捕获异常，都被中间件捕获并返回/Error/Error对应的错误页HTML，而非原始异常详情。

2. 前端Ajax失败回调处理

在data-ajax-failure="onFailure"对应的回调函数中，根据响应状态处理：

function onFailure(jqXHR) {
    // 服务器错误（如500）直接用返回的错误页HTML替换整个页面
    if (jqXHR.status >= 500) {
        document.open();
        document.write(jqXHR.responseText);
        document.close();
    } else {
        // 其他错误（如404）直接跳转到错误页路由
        window.location.href = '/Error/Error';
    }
}

关于开发环境的说明 #

开发环境默认使用的是调试用的异常页面（带堆栈信息），不会返回自定义错误页，所以在开发时看不到预期效果是正常的。如果需要在开发环境测试自定义错误页，可以临时注释掉开发环境的异常处理配置，或者单独为开发环境配置UseExceptionHandler。

另外，如果不想处理responseText，也可以在失败回调里直接跳转到错误页路由，这种方式更简单，也能保证统一使用自定义错误页：

function onFailure() {
    window.location.href = '/Error/Error';
}

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