.NET 6下Entity Framework查询需捕获的异常及错误处理方案

结论先行：这类只读查询场景优先用全局异常处理中间件做统一兜底，不要在每个Controller Action里重复编写try-catch逻辑，仅当该接口存在和全局逻辑不同的特殊错误处理需求时，才补充局部异常捕获。

为什么不推荐Action内单独捕获 #

• 冗余代码极难维护：系统中存在大量数据查询类接口时，每个Action重复写try-catch会产生大量重复代码，后续调整错误提示、日志规则时需要逐处修改，非常容易遗漏。
• 异常覆盖范围不全：Action层的try-catch只能捕获Action方法内部抛出的异常，无法覆盖过滤器、模型绑定、其他中间件执行过程中产生的错误，你本身无法预判所有只读查询的异常场景，局部捕获很容易出现漏网之鱼。
• 容易出现反模式：不少开发者写局部捕获时会直接吞掉异常返回空结果，用户会误以为"没有匹配数据"而非"查询出错"，会严重误导用户操作。

全局异常中间件的适配方案 #

ASP.NET Core 自带的全局异常处理中间件是官方推荐的管道级容错方案，天生覆盖整个请求管道的所有异常，完全可以满足你的友好提示需求，不需要每个接口单独写捕获：

1. 差异化返回逻辑：在中间件内判断请求路径和请求方法，针对客户查询的POST接口，不要直接跳转通用错误页，而是返回原Index视图，将用户提交的QueryModel参数重新绑定回模型，同时传入友好错误提示，保证用户之前填写的筛选条件不会丢失，体验远好于全页跳转。其他普通页面请求走通用错误页跳转逻辑即可。
2. 异常分类提示：针对常见的异常类型返回对应提示，不要把技术堆栈暴露给用户：
   • 数据库连接失败、服务不可用类异常：提示*"数据服务暂时不可用，请稍后重试"*
   • 查询超时类异常：提示*"当前查询范围过大导致超时，请缩小筛选条件后重试"*
   • 参数非法、动态排序字段不存在类异常：提示*"查询参数不合法，请检查筛选条件后重试"*
   • 其他未识别异常：统一提示*"查询执行失败，请稍后重试，若多次出现请联系管理员"*
3. 强制日志记录：所有捕获到的异常第一时间写入结构化日志，记录异常堆栈、请求参数、当前登录用户信息，方便后续排查问题。

常见异常及复现方法 #

你不需要预判所有异常，只读EF查询场景下高频可复现的异常只有几类，测试时很容易模拟：

• 数据库连接类异常：修改连接字符串为错误值、直接停掉数据库服务即可复现
• 查询超时异常：给DbContext设置极短的CommandTimeout（比如1秒），查询前锁定目标表即可触发
• 动态逻辑异常：传入不存在的sortBy字段值，触发动态拼接OrderBy时的参数异常
• 序列化/映射异常：配置错误的导航属性序列化规则（比如循环引用未处理）即可触发

注意：绝对不要在FilterCustomerList扩展方法内部catch所有异常直接返回空列表，这是非常差的实践，会完全掩盖故障。

什么时候需要局部捕获 #

只有当该查询接口存在特殊处理需求时，才需要在Action内部补充try-catch，比如：

• 异常触发时需要执行专属告警、降级逻辑（比如主库查询失败自动切只读库重试）
• 需要针对该接口的特定异常返回和全局规则完全不同的响应
  这类局部捕获记得只抓你明确要处理的特定异常类型，不要直接catch所有Exception吞掉，处理完特殊逻辑后如果不需要自定义响应，还是要把异常抛出交给全局中间件统一处理。

最简实现参考 #

.NET 6 中全局异常中间件的注册方式很简单，放在Program.cs中所有其他中间件的最前面即可：

app.UseExceptionHandler(errorApp =>
{
    errorApp.Run(async context =>
    {
        var exceptionFeature = context.Features.Get<IExceptionHandlerPathFeature>();
        var exception = exceptionFeature?.Error;
        // 此处编写日志记录逻辑，记录异常、请求路径、参数、用户信息

        // 客户查询接口特殊处理
        if (context.Request.Path.StartsWithSegments("/Customer/Query") 
            && context.Request.Method == HttpMethods.Post)
        {
            context.Response.StatusCode = StatusCodes.Status200OK;
            // 读取用户提交的原始查询参数
            using var reader = new StreamReader(context.Request.Body);
            var body = await reader.ReadToEndAsync();
            var queryParams = JsonSerializer.Deserialize<QueryModel>(body);
            
            // 渲染原视图，传入错误提示和原参数
            var viewResult = new ViewResult { ViewName = "Index" };
            viewResult.ViewData["ErrorMessage"] = GetFriendlyErrorMsg(exception);
            viewResult.ViewData["QueryModel"] = queryParams;
            
            // 此处通过IRazorViewEngine渲染视图返回即可
            return;
        }

        // 其余请求统一跳转通用错误页
        context.Response.Redirect("/Home/Error");
    });
});

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